prospectapis-mcp 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -6,6 +6,27 @@ All notable changes to `prospectapis-mcp` are documented here. The format follow
 
 ## [Unreleased]
 
+## [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
+
+- `server.json` lists the hosted endpoint `https://api.prospectapis.com/mcp` under `remotes` again. It moved here from
+  the earlier `io.github.ProspectAPIs/prospectapis-mcp` entry, which is retired in favour of this one (its 0.2.4
+  version, the one that listed the endpoint, is deleted from the registry). No code change; the tools, inputs and
+  outputs are the same as 0.4.1.
+
 ## [0.4.1] - 2026-10-26
 
 ### Changed
@@ -13,6 +34,9 @@ All notable changes to `prospectapis-mcp` are documented here. The format follow
 - The Official MCP Registry name is now `com.prospectapis/prospectapis-mcp` (`mcpName` in `package.json` and `name` in
   `server.json`), proved by a DNS record on prospectapis.com instead of a GitHub sign-in. No code change; the tools,
   inputs and outputs are the same as 0.4.0.
+- `server.json` no longer lists the hosted endpoint under `remotes`: the registry keeps each remote URL on one entry,
+  and `https://api.prospectapis.com/mcp` is already listed on the earlier `io.github.ProspectAPIs/prospectapis-mcp`
+  entry, which stays live. This entry lists the npm package.
 
 ## [0.4.0] - 2026-10-25
 

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 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.
 
 Install (Claude Code): `claude mcp add prospectapis -e PROSPECTAPIS_API_KEY=pa_live_... -- npx -y prospectapis-mcp`
 
@@ -10,14 +10,14 @@ 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 |
 | `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 |
@@ -66,7 +66,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.1",
+  "version": "0.4.3",
   "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",
@@ -28,6 +28,7 @@
     "test": "node --test \"test/**/*.test.js\"",
     "prepublishOnly": "npm test && node scripts/prepublish-tenant-check.mjs",
     "check:registry-drift": "node scripts/registry-drift.mjs",
+    "export:public": "node scripts/export-public.mjs",
     "postpublish": "node scripts/registry-drift.mjs --publish"
   },
   "dependencies": {

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,7 +74,7 @@ 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."),
     },
@@ -134,7 +135,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 +177,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 +253,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 +307,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'."),