prospectapis-mcp 0.4.3 → 0.9.0

package/CHANGELOG.md

@@ -6,6 +6,65 @@ All notable changes to `prospectapis-mcp` are documented here. The format follow
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-11-01
+
+### Added
+
+- `page_profile` (`GET /v1/pages/profile`, $0.012 per live read): read a company page's public fields fresh at request
+  time (name, website, description, industry, company type, employee count and size range, headquarters, founded year,
+  specialities, follower count, affiliated pages) by its public name or page address. Billed under the same
+  `people_reads` go-live switch as the other live reads, default off.
+
+### Changed
+
+- `company_get` also takes a company's exact name in `domain`. A name shared by several companies answers HTTP 300
+  with each `{name, domain}` to choose from, free; a name we hold no rounds for is a free 404.
+
+## [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

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.009, an email check $0.003 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 46 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`
 
@@ -12,6 +12,8 @@ Website: https://prospectapis.com/mcp
 |---|---|---|
 | `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.003 per `valid` or `invalid` result; `catch-all` and `unknown` are free; 1 to 25 addresses a call |
@@ -21,6 +23,25 @@ Website: https://prospectapis.com/mcp
 | `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 |
+| `page_profile` | `GET /v1/pages/profile` | $0.012 per live read; a page that cannot be read is free |
+| `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 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prospectapis-mcp",
-  "version": "0.4.3",
+  "version": "0.9.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/server.js

@@ -31,6 +31,7 @@ export const INSTRUCTIONS =
 export function hintFor(status) {
   if (status === 401) return " (missing or invalid API key: set PROSPECTAPIS_API_KEY to a key from the dashboard)";
   if (status === 402) return ` (out of credits for this call; the body says what it costs: top up at ${TOP_UP_URL})`;
+  if (status === 300) return " (several companies have that name: repeat the call with one of the listed domains)";
   if (status === 400) return " (an argument was rejected: the body says which one)";
   if (status === 404) return " (not found: the id may be wrong, or the record is not published)";
   if (status === 429) return " (rate limited: wait a few seconds and retry)";

package/src/tools.js

@@ -79,6 +79,46 @@ export const TOOLS = [
       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 or by company name: 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. A company name " +
+      "is matched whole against the funding rounds we hold: several companies with that name answer HTTP 300 with each " +
+      "`{name, domain}` to choose from (free, never a guess), and no company with that name is a free 404.",
+    shape: {
+      domain: z.string().min(2).max(253).describe("The company's domain, for example `acme.com`, or its exact name, for example `Acme Robotics`."),
+    },
+  },
+  {
+    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",
@@ -375,6 +415,321 @@ 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: "page_profile",
+    method: "GET",
+    path: "/v1/pages/profile",
+    title: "Read Company Page",
+    write: false,
+    description:
+      "Read a company page's public fields, FRESH at request time: name, website, tagline, description, industry, " +
+      "company type, employee count and size range, headquarters (city, region, country, postal code), founded year, " +
+      "specialities, follower count and affiliated pages. Costs $0.012 per live read; a page that cannot be read is " +
+      "free. Pass the page's public name or its page address as `page`.",
+    shape: {
+      page: z.string().min(1).max(300).describe("The company page's public name (the part after /company/) or its page address."),
+    },
+  },
+  {
+    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",