Prosp

Prosp (prosp.cc): B2B company finder. Describe the companies you want, get matches with contacts.

Hosted MCP Server

npx add-mcp 'https://api.prosp.cc/mcp-rpc'

Installs into Claude Code, Codex, Cursor and more

Documentation

Prosp runs a remote Model Context Protocol server, so an AI agent such as ChatGPT or Claude can start discoveries, poll them and read the results for you. The agent calls the same customer API that is documented in the API reference, so credits, rate limits and the customer-safe field set are identical on every surface.

Connect

Server URLhttps://api.prosp.cc/mcp-rpc (no trailing slash: /mcp-rpc/ answers with a redirect)
TransportStreamable HTTP
Sign-inOAuth 2.1 authorization code with PKCE. The agent registers itself and opens a sign-in window: choose Continue with Telegram, or sign in with an e-mailed one-time code. There are no API keys to paste.

Before you connect, open the Telegram bot @prosp_mcp_credits_bot, buy credits with /buy and run /connect; see the Telegram bot guide.

Your company does not use Telegram? Write to us and we set up API access for you.

Claude: Settings → Connectors → Add custom connector → paste the server URL → save, then complete the sign-in window.

ChatGPT: on a plan with connectors / developer mode enabled, Settings → Connectors → Add connector → paste the server URL → save, then complete the sign-in window.

Copy-paste setup for Claude Desktop and Cursor

There is nothing to replace: the server URL is public and there is no key in either file. The first time the assistant connects it opens a sign-in window (Continue with Telegram).

Cursor, in ~/.cursor/mcp.json (or the project's .cursor/mcp.json):

{
  "mcpServers": {
    "prosp": {
      "url": "https://api.prosp.cc/mcp-rpc"
    }
  }
}

Claude Desktop, in claude_desktop_config.json, through the mcp-remote bridge (needs Node.js). Claude Desktop can also add the URL directly under Settings, Connectors, as described above:

{
  "mcpServers": {
    "prosp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.prosp.cc/mcp-rpc"]
    }
  }
}

Then ask: "Find independent menswear retailers in Germany and Austria with 10-200 staff." A discovery costs 100 credits; Needs a Telegram account · introductory offer: about €2 for 200 searches (100 Stars).

Tools

The authoritative list is what the server answers to tools/list; this table mirrors it.

Discovery

ToolWhat it doesCredits
find_prospectsStart a discovery job from criteria (a natural-language query, plus optional industries, locations, company sizes, keywords, exclusions, sub-country regions and business models). Returns a jobId immediately; the job runs asynchronously, usually under half an hour; a hard search can take longer.100
get_discovery_statusPoll a job: lifecycle state, total_prospects so far, target, and the found domains, which accumulate while the job runs. Pass the previous next_cursor as cursor to receive only new domains.free
get_discovery_resultsResult summary and the discovered companies, with the contacts Prosp found, once the job is terminal.free
get_discovery_exportThe download link for a finished job's companies as an Excel (.xlsx) workbook: one row per company plus a Contacts sheet, the same fields as the CSV. The link needs the same bearer token as the other tools.free
cancel_discoveryCancel a running job. Credits are refunded only when nothing had been delivered at cancel time.free
search_prospectsSemantic free-text search over companies you have already discovered; lean summaries with has_more / next_cursor paging.free
get_prospectThe full record for one discovered company by domain.free
acknowledge_prospectsMark domains as delivered so they are not returned again. Idempotent.free

Saved ICPs (Ideal Customer Profiles)

ToolWhat it doesCredits
list_icpsList your saved ICPs.free
save_icpSave reusable discovery criteria; returns an icpId. Saving does not run a discovery.free
run_icpStart a discovery from a saved icpId.100

Credits

ToolWhat it does
get_credit_balanceRemaining balance and the per-job cost.
get_credit_ledgerEvery debit and refund behind the balance, newest first.

Odoo CRM

ToolWhat it does
set_odoo_credentialsConnect your own Odoo CRM so discovered prospects sync into it. The connection is validated live before it is saved; the API key is stored encrypted and never shown back.
get_crm_connectionShow the configured connection (never the key).
disconnect_crmStop syncing. Idempotent.

Circular-economy opportunities

ToolWhat it does
list_circular_opportunitiesOpportunities inferred from your own stored business profile. Each element carries a speech_act: ASSERT (you told us) or ASK (we inferred it, so it may only be raised as a question).
run_circular_opportunityStart a counterpart search for one opportunity by its handle. An inferred resource must be confirmed in your own words first. Debits 100 credits (it is a discovery).

Smart Messaging

Grounded outreach messages for one recipient company each. The recipient need not be a company Prosp found for you: a company Prosp does not know yet is researched first, then the message is composed. Prosp composes the text; it does not send it. A message states as fact only what Prosp holds a source for, about the recipient and about you; personal data is never stated.

ToolWhat it does
set_seller_profileSave your business description and website, used to ground every message. No credit cost.
get_seller_profileShow your seller profile and whether an offering was derived from your website. No credit cost.
delete_seller_profileRemove your seller profile. No credit cost.
generate_messageRegister one message generation for a recipient company, named by its domain; returns at once, the message is composed in the background. The company need not be one Prosp found for you: a company Prosp does not know yet is researched first, then the message is composed. Debits 10 credits, once, research included; a failed generation returns them.
get_message_generationStatus of a generation and, once it succeeded, the finished message. Kept for 7 days after it ends.
cancel_message_generationCancel a generation that has not finished. Credits come back only if composition had not started.

A typical conversation

  1. "Find independent menswear retailers in Germany and Austria with 10–200 staff."
  2. The agent calls find_prospects and keeps the jobId.
  3. It polls get_discovery_status; domains appear in found as they are validated.
  4. When the job is terminal it calls get_discovery_results and summarises the companies.
  5. Follow-ups such as "show me everything about the third one" use get_prospect.

Errors

Tool errors carry the same stable codes as the REST API, for example insufficient_credits (top up with /buy), rate_limit_exceeded (too many requests or too many concurrent jobs) and service_unavailable (retry shortly). Quote the request_id of any error when you ask for help.