MCP server for ChatGPT and Claude

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 URL https://api.prosp.cc/mcp-rpc (no trailing slash: /mcp-rpc/ answers with a redirect)
Transport Streamable HTTP
Sign-in OAuth 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.

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

Tool What it does Credits
find_prospects Start 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_status Poll 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_results Result summary and the discovered companies, with the contacts Prosp found, once the job is terminal. free
get_discovery_export The 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_discovery Cancel a running job. Credits are refunded only when nothing had been delivered at cancel time. free
search_prospects Semantic free-text search over companies you have already discovered; lean summaries with has_more / next_cursor paging. free
get_prospect The full record for one discovered company by domain. free
acknowledge_prospects Mark domains as delivered so they are not returned again. Idempotent. free

Saved ICPs (Ideal Customer Profiles)

Tool What it does Credits
list_icps List your saved ICPs. free
save_icp Save reusable discovery criteria; returns an icpId. Saving does not run a discovery. free
run_icp Start a discovery from a saved icpId. 100

Credits

Tool What it does
get_credit_balance Remaining balance and the per-job cost.
get_credit_ledger Every debit and refund behind the balance, newest first.

Odoo CRM

Tool What it does
set_odoo_credentials Connect 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_connection Show the configured connection (never the key).
disconnect_crm Stop syncing. Idempotent.

Circular-economy opportunities

Tool What it does
list_circular_opportunities Opportunities 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_opportunity Start 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.

Tool What it does
set_seller_profile Save your business description and website, used to ground every message. No credit cost.
get_seller_profile Show your seller profile and whether an offering was derived from your website. No credit cost.
delete_seller_profile Remove your seller profile. No credit cost.
generate_message Register 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_generation Status of a generation and, once it succeeded, the finished message. Kept for 7 days after it ends.
cancel_message_generation Cancel 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.

Start in Telegram API quick-start