prospectapis-mcp 0.4.2 → 0.8.0

package/CHANGELOG.md

@@ -6,6 +6,63 @@ All notable changes to `prospectapis-mcp` are documented here. The format follow
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-10-31
+
+### Added
+
+- `post_resharers` (`GET /v1/posts/resharers`, $0.012 per live read): read who reshared a public post, each resharer
+  enriched, with the reshare type (`repost` for a plain reshare or `repost_with_thoughts` for a quote) and the added
+  `commentary` text of a with-thoughts reshare (roadmap PA-3.2). No competitor exposes reshare-with-commentary intent.
+  Whether a call is billed is gated server-side by the `people_reads` go-live switch, default off. The underlying read
+  ships UNVERIFIED (its reshares recipe is pending a live capture), so the tool answers temporarily unavailable until an
+  operator enables it on the server.
+
+## [0.7.0] - 2026-10-31
+
+### Added
+
+- Twelve tools for the people/post WRITE product and the messaging reads (roadmap PA-3.4, task #46, backlog #18), each
+  acting on your own connected account. Writes, one published price PER route, metered, no floor, no seat:
+  `message_send` (`POST /v1/messages`, $0.03), `person_invite` (`POST /v1/people/invite`, $0.03), `invite_withdraw`
+  (`POST /v1/people/invite/withdraw`, $0.01), `person_follow` (`POST /v1/people/follow`, $0.01), `person_visit`
+  (`POST /v1/people/visit`, $0.01), `post_create` (`POST /v1/posts`, $0.05), `post_react` (`POST /v1/posts/react`,
+  $0.005), `post_comment` (`POST /v1/posts/comment`, $0.02), `post_repost` (`POST /v1/posts/repost`, $0.01) and
+  `post_quote` (`POST /v1/posts/quote`, $0.02). Messaging reads at $0.01 per read: `messages_list` (`GET /v1/messages`)
+  and `message_thread` (`GET /v1/messages/thread`). Whether a call is billed is gated server-side by each family's
+  go-live switch; until it is on, the routes answer as before and are free. Connecting your own account stays free.
+
+## [0.6.0] - 2026-10-31
+
+### Added
+
+- Two tools for the cited company profile endpoint (roadmap PA-2.1a): `company_get` (`GET /v1/companies/:domain`,
+  $0.02 per company returned; a building 202 or an unknown 404 is free) and `company_funding`
+  (`GET /v1/companies/:domain/funding`, $0.009 per funding record returned). Billing of the profile is gated
+  server-side by the company go-live switch.
+
+## [0.5.0] - 2026-10-31
+
+### Added
+
+- Five live-read tools for the people and page reads (roadmap PA-3.2), one published price of $0.012 per live read,
+  each fetching the person or page fresh at request time: `people_profile` (`GET /v1/people/profile`), `people_search`
+  (`POST /v1/people/search`), `people_posts` (`GET /v1/people/posts`), `post_engagers` (`GET /v1/posts/engagers`) and
+  `page_followers` (`GET /v1/pages/followers`). All read-only and billed per call (not idempotent, like the funding
+  reads). Whether a call is billed is gated server-side by the API's go-live switch; until it is on, the reads answer
+  as before and are free.
+
+## [0.4.3] - 2026-10-31
+
+### Changed
+
+- Tool descriptions, the server instructions, the playbooks and the README state the lower API prices (roadmap PA-C.1):
+  `funding_search` and `funding_get` $0.009 per record returned, `email_verify` and verification jobs $0.003 per valid
+  or invalid result, `email_find` $0.009 per found address, a watchlist delivery $0.009. No change to tools, inputs or
+  outputs.
+- `funding_search`/`funding_get` describe the headquarters as `location` (the place as the source states it, often a
+  city) alongside `country` (the country name) and `country_code`, and the `country` filter matches a name or ISO code
+  against the country and any other text against the stated place. Reflects the API's country/location split.
+
 ## [0.4.2] - 2026-10-29
 
 ### Changed

package/README.md

@@ -1,6 +1,6 @@
 # prospectapis-mcp
 
-prospectapis-mcp is the MCP server for ProspectAPIs (https://prospectapis.com), for sales and prospecting teams and the AI agents they run in Claude Code, Claude Desktop, Cursor and other MCP clients. It gives your agent twenty-five tools over the ProspectAPIs API: search funding rounds by date, round, amount, company, investor and country, get new matching rounds pushed to your webhook, verify, find and bulk-check email addresses, report what bounced, and order a cited research brief on any company or person. Funding records carry the public announcement URL when there is one. Every account starts with a free $1 balance and no card: records cost $0.02, an email check $0.004 and a completed brief $0.15, with no seats and no subscription. It needs Node.js 22 or later.
+prospectapis-mcp is the MCP server for ProspectAPIs (https://prospectapis.com), for sales and prospecting teams and the AI agents they run in Claude Code, Claude Desktop, Cursor and other MCP clients. It gives your agent 45 tools over the ProspectAPIs API: search and watch funding rounds, read cited company profiles, verify, find and bulk-check email addresses, order a cited research brief, read people and pages live, and act through your own connected account (message, invite, follow, post, react, comment and more). Every account starts with a free $1 balance and no card: records cost $0.009, an email check $0.003, a brief $0.15, a live read $0.012 and an action from $0.005, with no seats and no subscription. It needs Node.js 22 or later.
 
 Install (Claude Code): `claude mcp add prospectapis -e PROSPECTAPIS_API_KEY=pa_live_... -- npx -y prospectapis-mcp`
 
@@ -10,17 +10,37 @@ Website: https://prospectapis.com/mcp
 
 | Tool | Endpoint | Cost |
 |---|---|---|
-| `funding_search` | `GET /v1/funding` | $0.02 per record returned; no match is free |
-| `funding_get` | `GET /v1/funding/:id` | $0.02 when found; a missing id is free |
+| `funding_search` | `GET /v1/funding` | $0.009 per record returned; no match is free |
+| `funding_get` | `GET /v1/funding/:id` | $0.009 when found; a missing id is free |
+| `company_get` | `GET /v1/companies/:domain` | $0.02 per company returned; a building (202) or unknown (404) domain is free |
+| `company_funding` | `GET /v1/companies/:domain/funding` | $0.009 per record returned; a company with no rounds is free |
 | `research_submit` | `POST /v1/research` | one research at `research_price_usd` (see `account_balance`), charged only when the brief completes; refunded on failure |
 | `research_get` | `GET /v1/research/:id` | free; poll until `status` is `completed` or `failed` |
-| `email_verify` | `POST /v1/email/verify` | $0.004 per `valid` or `invalid` result; `catch-all` and `unknown` are free; 1 to 25 addresses a call |
+| `email_verify` | `POST /v1/email/verify` | $0.003 per `valid` or `invalid` result; `catch-all` and `unknown` are free; 1 to 25 addresses a call |
 | `email_verify_stats` | `GET /v1/email/verify/stats` | free |
 | `email_outcomes_report` | `POST /v1/email/outcomes` | free; 1 to 100 outcomes a call |
-| `email_verify_job_create` | `POST /v1/email/verify/jobs` | free to start; $0.004 per `valid` or `invalid` result as it is checked; up to 50,000 addresses |
+| `email_verify_job_create` | `POST /v1/email/verify/jobs` | free to start; $0.003 per `valid` or `invalid` result as it is checked; up to 50,000 addresses |
 | `email_verify_job_get` | `GET /v1/email/verify/jobs/:id` | free |
 | `email_verify_job_results` | `GET /v1/email/verify/jobs/:id/results` | free; 1,000 a page |
 | `watchlist_create`, `watchlist_list`, `watchlist_get`, `watchlist_deliveries`, `watchlist_test`, `watchlist_delete` | `/v1/watchlists` | free to manage; a delivered event costs one record, only when your webhook answers 2xx |
+| `people_profile` | `GET /v1/people/profile` | $0.012 per live read; a profile that cannot be read is free |
+| `people_search` | `POST /v1/people/search` | $0.012 per live read; up to 1,000 results a query |
+| `people_posts` | `GET /v1/people/posts` | $0.012 per live read |
+| `post_engagers` | `GET /v1/posts/engagers` | $0.012 per live read |
+| `post_resharers` | `GET /v1/posts/resharers` | $0.012 per live read; names the reshare type and the with-thoughts commentary |
+| `page_followers` | `GET /v1/pages/followers` | $0.012 per live read; your connected account must administer the page |
+| `message_send` | `POST /v1/messages` | $0.03 per action; on your connected account |
+| `person_invite` | `POST /v1/people/invite` | $0.03 per action |
+| `invite_withdraw` | `POST /v1/people/invite/withdraw` | $0.01 per action |
+| `person_follow` | `POST /v1/people/follow` | $0.01 per action |
+| `person_visit` | `POST /v1/people/visit` | $0.01 per action |
+| `post_create` | `POST /v1/posts` | $0.05 per action |
+| `post_react` | `POST /v1/posts/react` | $0.005 per action |
+| `post_comment` | `POST /v1/posts/comment` | $0.02 per action |
+| `post_repost` | `POST /v1/posts/repost` | $0.01 per action |
+| `post_quote` | `POST /v1/posts/quote` | $0.02 per action |
+| `messages_list` | `GET /v1/messages` | $0.01 per read; your connected-account conversations |
+| `message_thread` | `GET /v1/messages/thread` | $0.01 per read |
 | `account_balance` | `GET /v1/account` | free |
 | `feedback_send` | `POST /v1/feedback` | free; reports a bug, wrong field or missing capability to the team (10 an hour per key) |
 | `pricing_get` | `GET /pricing` | free, no key needed; the live price list |
@@ -66,7 +86,7 @@ Claude Code: `claude mcp add prospectapis -e PROSPECTAPIS_API_KEY=pa_live_... --
 
 **Where does the funding data come from?** Records carry the public announcement URL when there is one.
 
-**What is free?** A $1 balance when you sign up (about 50 funding records, 250 email checks or 6 research briefs), any search that matches nothing, catch-all and unknown email results, watchlist management, and the balance, pricing and version tools.
+**What is free?** A $1 balance when you sign up (about 111 funding records, 333 email checks or 6 research briefs), any search that matches nothing, catch-all and unknown email results, watchlist management, and the balance, pricing and version tools.
 
 **Which clients work?** Claude Code, Claude Desktop, Cursor and any client that reads an mcpServers config, through `npx -y prospectapis-mcp`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prospectapis-mcp",
-  "version": "0.4.2",
+  "version": "0.8.0",
   "mcpName": "com.prospectapis/prospectapis-mcp",
   "description": "MCP server for ProspectAPIs: search funding rounds, verify email addresses, run paid prospect research briefs, manage funding watchlists, read your balance and the live price list.",
   "type": "module",

package/src/playbooks.js

@@ -20,8 +20,8 @@ const NEWLY_FUNDED = `# Newly funded prospects
 
 Build a short list of companies that just raised, worth reaching out to while the round is fresh.
 
-1. \`account_balance\` first. Each funding record returned costs $0.02, drawn from your balance (a new account starts
-   with $1, about 50 records), so know what is left before you pull pages.
+1. \`account_balance\` first. Each funding record returned costs $0.009, drawn from your balance (a new account starts
+   with $1, about 111 records), so know what is left before you pull pages.
 2. \`funding_search\` with a tight window and the filters that describe the buyer: \`since\` (for example the last 30
    days), \`round\` (such as \`seed,series_a\`), \`country\`, and \`min_amount_usd\` or \`max_amount_usd\`. Start with
    \`limit\` 10 to 25. A search that matches nothing costs nothing, so narrow before you widen.

package/src/server.js

@@ -19,8 +19,8 @@ export const TOP_UP_URL = "https://prospectapis.com/dashboard/billing?utm_source
 
 export const INSTRUCTIONS =
   "ProspectAPIs MCP server: funding rounds data, email verification and prospect research briefs. Every account starts with a free $1 balance " +
-  "(no card, no monthly reset), and each paid call draws from it at its own price. funding_search and funding_get cost $0.02 per record returned; " +
-  "a search that matches nothing costs nothing. email_verify checks 1 to 25 addresses for $0.004 per valid or invalid result; catch-all and " +
+  "(no card, no monthly reset), and each paid call draws from it at its own price. funding_search and funding_get cost $0.009 per record returned; " +
+  "a search that matches nothing costs nothing. email_verify checks 1 to 25 addresses for $0.003 per valid or invalid result; catch-all and " +
   "unknown results are free. account_balance, pricing_get and api_version are free. " +
   "Use filters (dates, round, amount, domain, investor, country) to keep result sets small, and call account_balance before a large paged search. " +
   "research_submit starts a cited brief on one prospect and returns a research_id; poll research_get (free) until it is completed or failed. " +

package/src/tools.js

@@ -48,8 +48,9 @@ export const TOOLS = [
     write: false,
     format: { min_amount_usd: formatAmount, max_amount_usd: formatAmount },
     description:
-      "Search funding rounds (venture rounds, debt, grants, IPOs), newest announcement first. Costs $0.02 per record returned, drawn from your balance (every account starts with a free $1); a search that matches nothing is free. " +
-      "Page with `cursor`: pass back `next_cursor` exactly as returned; a null `next_cursor` means there are no more matches. Narrow with filters before raising `limit`.",
+      "Search funding rounds (venture rounds, debt, grants, IPOs), newest announcement first. Costs $0.009 per record returned, drawn from your balance (every account starts with a free $1); a search that matches nothing is free. " +
+      "Page with `cursor`: pass back `next_cursor` exactly as returned; a null `next_cursor` means there are no more matches. Narrow with filters before raising `limit`. " +
+      "Each record gives the headquarters as `location` (the place as the source states it, often a city) and `country` (the country name), plus `country_code` (the ISO 3166-1 alpha-2 code).",
     shape: {
       since: DATE.describe("Earliest announcement date, inclusive (YYYY-MM-DD)."),
       until: DATE.describe("Latest announcement date, inclusive (YYYY-MM-DD)."),
@@ -62,7 +63,7 @@ export const TOOLS = [
       company: z.string().min(1).max(100).optional().describe("Company name contains this text (case-insensitive)."),
       domain: z.string().min(3).max(253).optional().describe("Exact company domain, for example `example.com`."),
       investor: z.string().min(1).max(100).optional().describe("Exact investor name, case-insensitive."),
-      country: z.string().min(1).max(60).optional().describe("Headquarters country as a name or ISO code, such as US, United States or DE. Other text, such as a city, matches the stated location."),
+      country: z.string().min(1).max(60).optional().describe("Headquarters country as a name or ISO code, such as US, United States or DE. Other text, such as a city, matches the stated place (the record's `location`)."),
       limit: z.number().int().min(1).max(100).optional().describe("Records per page, 1 to 100 (default 25). Each record returned is billed."),
       cursor: z.string().max(200).optional().describe("Opaque cursor from the previous page's `next_cursor`."),
     },
@@ -73,11 +74,49 @@ export const TOOLS = [
     path: "/v1/funding/{id}",
     title: "Get Funding Round",
     write: false,
-    description: "Read one funding record by id. Costs $0.02 when found; a missing id is free.",
+    description: "Read one funding record by id. Costs $0.009 when found; a missing id is free.",
     shape: {
       id: z.string().uuid().describe("The funding record id from a `funding_search` result."),
     },
   },
+  {
+    name: "company_get",
+    method: "GET",
+    path: "/v1/companies/{domain}",
+    title: "Get Company Profile",
+    write: false,
+    description:
+      "Read one cited company profile by domain: name, description, HQ, founded year, industry, employee band, social " +
+      "links, a funding rollup (the amount raised across the rounds we hold, not lifetime total raised) and a careers " +
+      "link, with a source URL on every field and each marked `stated` (a page " +
+      "states it) or `inferred` (classified from a page); a field no source supports is null, never guessed. Costs " +
+      "$0.02 per company returned, drawn from your balance. A domain not built yet returns 202 `building` (retry in " +
+      "about 30 seconds), and a domain that does not resolve to a company returns 404; both are free.",
+    shape: {
+      domain: z.string().min(3).max(253).describe("The company's domain, for example `acme.com`."),
+    },
+  },
+  {
+    name: "company_funding",
+    method: "GET",
+    path: "/v1/companies/{domain}/funding",
+    title: "Get Company Funding Rounds",
+    write: false,
+    format: { min_amount_usd: formatAmount, max_amount_usd: formatAmount },
+    description:
+      "The funding rounds for one company domain, newest announcement first: the same records as funding_search filtered " +
+      "to this domain. Costs $0.009 per record returned; a company with no rounds is free. Page with `cursor`.",
+    shape: {
+      domain: z.string().min(3).max(253).describe("The company's domain, for example `acme.com`."),
+      since: DATE.describe("Earliest announcement date, inclusive (YYYY-MM-DD)."),
+      until: DATE.describe("Latest announcement date, inclusive (YYYY-MM-DD)."),
+      round: z.string().optional().describe("Comma-separated round stages, for example `seed,series_a`."),
+      min_amount_usd: AMOUNT.describe("Smallest round size in USD."),
+      max_amount_usd: AMOUNT.describe("Largest round size in USD."),
+      limit: z.number().int().min(1).max(100).optional().describe("Records per page, 1 to 100 (default 25). Each record returned is billed."),
+      cursor: z.string().max(200).optional().describe("Opaque cursor from the previous page's `next_cursor`."),
+    },
+  },
   {
     name: "research_submit",
     method: "POST",
@@ -134,7 +173,7 @@ export const TOOLS = [
     body: true,
     description:
       "Check whether 1 to 25 email addresses can receive mail. Each result has `status` (valid, invalid, catch-all or unknown), " +
-      "`reason`, `reason_text`, `score` (0 to 100), `recommendation` (send, send_with_caution, retry_later or do_not_send), `charged`, `flags`, `smtp_code`, `catch_all_tier`, `did_you_mean` (a likely domain typo), `mail_provider` and `checked_at`. Costs $0.004 per valid or invalid result, drawn from your " +
+      "`reason`, `reason_text`, `score` (0 to 100), `recommendation` (send, send_with_caution, retry_later or do_not_send), `charged`, `flags`, `smtp_code`, `catch_all_tier`, `did_you_mean` (a likely domain typo), `mail_provider` and `checked_at`. Costs $0.003 per valid or invalid result, drawn from your " +
       "balance; catch-all and unknown results are free (pricing_get lists which statuses are charged). When the balance covers only " +
       "some addresses, the rest come back `unknown` with reason `not_checked_insufficient_credits`, free. " +
       "`depth: \"quick\"` never contacts the mail server: syntax, disposable and free lists, DNS, parked and new-domain flags " +
@@ -176,7 +215,7 @@ export const TOOLS = [
     description:
       "Find a person's work email from `first_name`, `last_name` and company `domain`. The common patterns are checked in order " +
       "against the mail server, most common first. Returns `status` (found, catch_all, unknown, not_found), `email`, `pattern`, " +
-      "`score`, `recommendation` and the addresses `checked`. Costs $0.02 only when an address is found; on a catch-all domain " +
+      "`score`, `recommendation` and the addresses `checked`. Costs $0.009 only when an address is found; on a catch-all domain " +
       "it returns the most likely address as `best_guess`, free.",
     shape: {
       first_name: z.string().min(1).max(80).describe("The person's first name."),
@@ -252,7 +291,7 @@ export const TOOLS = [
     body: true,
     description:
       "Check up to 50,000 addresses in the background. Returns 202 with a job `id`; poll email_verify_job_get. A slow or " +
-      "greylisting server is retried about 5, 15 and 30 minutes later, free. Each valid or invalid result costs $0.004 as " +
+      "greylisting server is retried about 5, 15 and 30 minutes later, free. Each valid or invalid result costs $0.003 as " +
       "it is checked; catch-all and unknown are free. An optional https `callback_url` gets one signed POST when the job " +
       "completes (verify with the returned `secret`). At most 5 jobs run at once per account.",
     shape: {
@@ -306,7 +345,7 @@ export const TOOLS = [
     description:
       "Save a funding-signal alert: a set of funding_search filters plus an https webhook. Each NEW funding event that " +
       "matches is POSTed to the webhook, signed with the returned `secret` (header Prospect-Signature: t=..,v1=HMAC-SHA256). " +
-      "Creating is free; each delivered event costs one record ($0.02), charged only when the webhook " +
+      "Creating is free; each delivered event costs one record ($0.009), charged only when the webhook " +
       "answers 2xx. The `secret` is shown once. Max 20 active per account.",
     shape: {
       name: z.string().min(1).max(100).describe("A label, such as 'Series A robotics'."),
@@ -374,6 +413,306 @@ export const TOOLS = [
     description: "Delete a funding-signal alert and its delivery history. Free.",
     shape: { id: z.string().uuid().describe("The watchlist id.") },
   },
+  {
+    name: "people_profile",
+    method: "GET",
+    path: "/v1/people/profile",
+    title: "Read Person Profile",
+    write: false,
+    description:
+      "Read one person's public professional profile, fetched FRESH at request time (never from a stored cache). " +
+      "Costs $0.012 per live read, drawn from your balance; a profile that cannot be read is free. Pass a public " +
+      "identifier or profile address as `profile_ref`.",
+    shape: {
+      profile_ref: z.string().min(1).max(300).describe("A person's public identifier or profile address."),
+    },
+  },
+  {
+    name: "people_search",
+    method: "POST",
+    path: "/v1/people/search",
+    title: "Search People",
+    write: false,
+    body: true,
+    description:
+      "Search people by keywords and filters, read FRESH at request time. Returns the first 1,000 results per query; " +
+      "page with `start`. Costs $0.012 per live read. Give `keywords` or at least one filter.",
+    shape: {
+      keywords: z.string().min(1).max(500).optional().describe("Free-text keywords."),
+      filters: z
+        .object({
+          network: z.string().optional(),
+          current_company: z.string().optional(),
+          past_company: z.string().optional(),
+          location: z.string().optional(),
+          industry: z.string().optional(),
+          school: z.string().optional(),
+          profile_language: z.string().optional(),
+          connection_of: z.string().optional(),
+          service_category: z.string().optional(),
+          first_name: z.string().optional(),
+          last_name: z.string().optional(),
+          title: z.string().optional(),
+          company: z.string().optional(),
+          school_name: z.string().optional(),
+        })
+        .partial()
+        .optional()
+        .describe("Named filters: network, current_company, past_company, location, industry, school, profile_language, connection_of, service_category, first_name, last_name, title, company, school_name."),
+      start: z.number().int().min(0).max(999).optional().describe("Zero-based offset into the first 1,000 results."),
+      count: z.number().int().min(1).max(50).optional().describe("Results per page, 1 to 50."),
+    },
+  },
+  {
+    name: "people_posts",
+    method: "GET",
+    path: "/v1/people/posts",
+    title: "Read Person Posts",
+    write: false,
+    description:
+      "Read a person's recent public posts, FRESH at request time. Costs $0.012 per live read. Page with `cursor` " +
+      "(pass back the returned cursor) or `start`.",
+    shape: {
+      person_ref: z.string().min(1).max(4000).describe("The person reference from a profile or search result."),
+      start: z.number().int().min(0).max(10000).optional().describe("Zero-based offset."),
+      count: z.number().int().min(1).max(50).optional().describe("Posts per page, 1 to 50."),
+      cursor: z.string().max(4000).optional().describe("Opaque cursor from the previous page."),
+    },
+  },
+  {
+    name: "post_engagers",
+    method: "GET",
+    path: "/v1/posts/engagers",
+    title: "Read Post Engagers",
+    write: false,
+    description:
+      "Read who reacted to or commented on a public post, FRESH at request time. Costs $0.012 per live read. Set " +
+      "`kind` to reactions or comments and give one of post_id, share_id or post_url.",
+    shape: {
+      kind: z.enum(["reactions", "comments"]).describe("reactions (who reacted) or comments (who commented)."),
+      post_id: z.string().min(1).max(4000).optional().describe("The post id."),
+      share_id: z.string().min(1).max(4000).optional().describe("The share id."),
+      post_url: z.string().min(1).max(2048).optional().describe("The public post URL."),
+      start: z.number().int().min(0).max(100000).optional().describe("Reactions only: zero-based offset."),
+      count: z.number().int().min(1).max(50).optional().describe("Results per page, 1 to 50."),
+      cursor: z.string().max(4000).optional().describe("Comments only: opaque cursor from the previous page."),
+    },
+  },
+  {
+    name: "post_resharers",
+    method: "GET",
+    path: "/v1/posts/resharers",
+    title: "Read Post Resharers",
+    write: false,
+    description:
+      "Read who reshared a public post, FRESH at request time, with each resharer enriched. Costs $0.012 per live " +
+      "read. Each result carries reshare_type (repost or repost_with_thoughts) and, for a with-thoughts reshare, the " +
+      "added commentary text. Give one of post_id, share_id or post_url.",
+    shape: {
+      post_id: z.string().min(1).max(4000).optional().describe("The post id."),
+      share_id: z.string().min(1).max(4000).optional().describe("The share id."),
+      post_url: z.string().min(1).max(2048).optional().describe("The public post URL."),
+      start: z.number().int().min(0).max(100000).optional().describe("Zero-based offset."),
+      count: z.number().int().min(1).max(50).optional().describe("Results per page, 1 to 50."),
+    },
+  },
+  {
+    name: "page_followers",
+    method: "GET",
+    path: "/v1/pages/followers",
+    title: "Read Page Followers",
+    write: false,
+    description:
+      "Read the followers of a page your connected account administers, FRESH at request time. Costs $0.012 per live " +
+      "read. Give `page`, or the `cursor` of the previous page. Requires a connected account (people_search aside, " +
+      "this read runs on your own account).",
+    shape: {
+      page: z.string().min(1).max(300).optional().describe("The page identifier or address."),
+      count: z.number().int().min(1).max(20).optional().describe("Followers per page, 1 to 20."),
+      cursor: z.string().max(4000).optional().describe("Opaque cursor from the previous page."),
+    },
+  },
+  {
+    name: "message_send",
+    method: "POST",
+    path: "/v1/messages",
+    title: "Send Direct Message",
+    write: true,
+    body: true,
+    description:
+      "Send a direct message from YOUR connected account. Costs $0.03 per action, drawn from your balance; billing " +
+      "turns on with the write go-live switch (free until then). Requires a connected account (accounts_connect).",
+    shape: {
+      person_ref: z.string().min(1).max(4000).describe("The person reference from a profile or search result."),
+      text: z.string().min(1).max(8000).describe("The message text."),
+    },
+  },
+  {
+    name: "person_invite",
+    method: "POST",
+    path: "/v1/people/invite",
+    title: "Send Connection Invite",
+    write: true,
+    body: true,
+    description: "Send a connection invite from your connected account. Costs $0.03 per action. Requires a connected account.",
+    shape: {
+      person_ref: z.string().min(1).max(4000).describe("The person reference from a profile or search result."),
+    },
+  },
+  {
+    name: "invite_withdraw",
+    method: "POST",
+    path: "/v1/people/invite/withdraw",
+    title: "Withdraw Connection Invite",
+    write: true,
+    body: true,
+    description: "Withdraw a connection invite you sent. Costs $0.01 per action. Requires a connected account.",
+    shape: {
+      person_ref: z.string().min(1).max(4000).describe("The person reference the invite was sent to."),
+    },
+  },
+  {
+    name: "person_follow",
+    method: "POST",
+    path: "/v1/people/follow",
+    title: "Follow or Unfollow a Person",
+    write: true,
+    body: true,
+    description: "Follow a person, or unfollow with `unfollow: true`. Costs $0.01 per action. Requires a connected account.",
+    shape: {
+      person_ref: z.string().min(1).max(4000).describe("The person reference from a profile or search result."),
+      unfollow: z.boolean().optional().describe("true to unfollow instead of follow."),
+    },
+  },
+  {
+    name: "person_visit",
+    method: "POST",
+    path: "/v1/people/visit",
+    title: "Visit a Profile",
+    write: true,
+    body: true,
+    description:
+      "Visit a profile from your connected account (the 'viewed you' signal). Costs $0.01 per action. Give person_ref " +
+      "or profile_ref. Requires a connected account.",
+    shape: {
+      person_ref: z.string().min(1).max(4000).optional().describe("The person reference from a profile or search result."),
+      profile_ref: z.string().min(1).max(300).optional().describe("A person's public identifier or profile address."),
+    },
+  },
+  {
+    name: "post_create",
+    method: "POST",
+    path: "/v1/posts",
+    title: "Create a Post",
+    write: true,
+    body: true,
+    description: "Create a post (share) from your connected account. Costs $0.05 per action. Requires a connected account.",
+    shape: {
+      text: z.string().min(1).max(3000).describe("The post text."),
+      visibility: z.enum(["anyone", "connections"]).optional().describe("Who can see it; defaults to anyone."),
+    },
+  },
+  {
+    name: "post_react",
+    method: "POST",
+    path: "/v1/posts/react",
+    title: "React to a Post",
+    write: true,
+    body: true,
+    description:
+      "React to a post, or remove your reaction with `remove: true`. Costs $0.005 per action. Give one of post_id, " +
+      "share_id or post_url. Requires a connected account.",
+    shape: {
+      post_id: z.string().min(1).max(4000).optional().describe("The post id."),
+      share_id: z.string().min(1).max(4000).optional().describe("The share id."),
+      post_url: z.string().min(1).max(2000).optional().describe("The public post URL."),
+      reaction: z.enum(["like", "celebrate", "support", "love", "insightful", "funny"]).optional().describe("The reaction; defaults to like."),
+      remove: z.boolean().optional().describe("true to remove your reaction instead."),
+    },
+  },
+  {
+    name: "post_comment",
+    method: "POST",
+    path: "/v1/posts/comment",
+    title: "Comment on a Post",
+    write: true,
+    body: true,
+    description:
+      "Comment on a post, or reply to a comment with `parent_comment`. Costs $0.02 per action. Give one of post_id, " +
+      "share_id or post_url. Requires a connected account.",
+    shape: {
+      text: z.string().min(1).max(3000).describe("The comment text."),
+      post_id: z.string().min(1).max(4000).optional().describe("The post id."),
+      share_id: z.string().min(1).max(4000).optional().describe("The share id."),
+      post_url: z.string().min(1).max(2000).optional().describe("The public post URL."),
+      parent_comment: z.string().min(1).max(4000).optional().describe("A comment reference to reply under."),
+    },
+  },
+  {
+    name: "post_repost",
+    method: "POST",
+    path: "/v1/posts/repost",
+    title: "Repost a Post",
+    write: true,
+    body: true,
+    description:
+      "Repost a post (instant repost, no commentary). Costs $0.01 per action. Give one of post_id, share_id or " +
+      "post_url. Requires a connected account.",
+    shape: {
+      post_id: z.string().min(1).max(4000).optional().describe("The post id."),
+      share_id: z.string().min(1).max(4000).optional().describe("The share id."),
+      post_url: z.string().min(1).max(2000).optional().describe("The public post URL."),
+    },
+  },
+  {
+    name: "post_quote",
+    method: "POST",
+    path: "/v1/posts/quote",
+    title: "Quote a Post",
+    write: true,
+    body: true,
+    description:
+      "Quote a post with your own thoughts (repost with commentary). Costs $0.02 per action. Give one of post_id, " +
+      "share_id or post_url. Requires a connected account.",
+    shape: {
+      text: z.string().min(1).max(3000).describe("Your commentary."),
+      post_id: z.string().min(1).max(4000).optional().describe("The post id."),
+      share_id: z.string().min(1).max(4000).optional().describe("The share id."),
+      post_url: z.string().min(1).max(2000).optional().describe("The public post URL."),
+      visibility: z.enum(["anyone", "connections"]).optional().describe("Who can see it; defaults to anyone."),
+    },
+  },
+  {
+    name: "messages_list",
+    method: "GET",
+    path: "/v1/messages",
+    title: "List Conversations",
+    write: false,
+    description:
+      "Read your connected account's recent conversations, incremental by `since`/`cursor`. Costs $0.01 per read; " +
+      "billing turns on with the messaging go-live switch (free until then). Requires a connected account.",
+    shape: {
+      since: z.string().min(1).max(4000).optional().describe("Read only what changed after this value from a previous read."),
+      cursor: z.string().min(1).max(4000).optional().describe("Opaque cursor from the previous page."),
+      count: z.number().int().min(1).max(20).optional().describe("Conversations per page, 1 to 20."),
+    },
+  },
+  {
+    name: "message_thread",
+    method: "GET",
+    path: "/v1/messages/thread",
+    title: "Read a Conversation Thread",
+    write: false,
+    description:
+      "Read the messages of one conversation thread, incremental by `since`/`cursor`. Costs $0.01 per read. Pass the " +
+      "`thread_id` from messages_list. Requires a connected account.",
+    shape: {
+      thread_id: z.string().min(1).max(4000).describe("The thread id from messages_list."),
+      since: z.string().min(1).max(4000).optional().describe("Read only what changed after this value from a previous read."),
+      cursor: z.string().min(1).max(4000).optional().describe("Opaque cursor from the previous page."),
+      count: z.number().int().min(1).max(50).optional().describe("Messages per page, 1 to 50."),
+    },
+  },
   {
     name: "account_balance",
     method: "GET",