prospectapis-mcp 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -6,6 +6,20 @@ 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

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 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.
+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`
 
@@ -29,6 +29,7 @@ Website: https://prospectapis.com/mcp
 | `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 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prospectapis-mcp",
-  "version": "0.8.0",
+  "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

@@ -86,14 +86,16 @@ export const TOOLS = [
     title: "Get Company Profile",
     write: false,
     description:
-      "Read one cited company profile by domain: name, description, HQ, founded year, industry, employee band, social " +
+      "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.",
+      "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(3).max(253).describe("The company's domain, for example `acme.com`."),
+      domain: z.string().min(2).max(253).describe("The company's domain, for example `acme.com`, or its exact name, for example `Acme Robotics`."),
     },
   },
   {
@@ -532,6 +534,21 @@ export const TOOLS = [
       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",