API & MCP

Your Prosperian prospecting, from Claude or via API

Run your B2B prospecting from Claude, or automate it from your own tools.

Connect my AI assistant Integrate the HTTP API

API key, documentation and MCP server included in every plan. Some advanced features are reserved for the Enterprise plan. See pricing

Connect your AI assistant (MCP)

You need a Prosperian account and the administrator role in the organization you want to connect.

You ask

“List my active campaigns”

Claude calls the list_campaigns tool on your organization and answers with your campaigns.

On claude.ai

Open Settings, then Connectors, then Add custom connector.
Paste the server URL below. Leave the Client ID and Client Secret fields empty.
Sign in to Prosperian, pick the organization, then approve.
Ask Claude: “List my active campaigns”. You see your active campaigns, or an empty list if none is active.

MCP server URL

https://app.prosperian.co/api/mcp

In Claude Code

With Claude Code installed, add the server:

claude mcp add --transport http prosperian https://app.prosperian.co/api/mcp

Then, in Claude Code, type /mcp, pick prosperian and sign in to Prosperian (same administrator consent as on claude.ai).

The connector authenticates with OAuth: do not paste an API key into the connector. The API key is for the HTTP API.

Four actions wait for your approval before they run: attaching prospects, activating a sequence, enriching a contact, enriching a list. You approve them in Prosperian, under Agent, then “À valider” (pending approvals) in the app.

If it doesn't work

“Couldn't reach the MCP server”: the URL must be exactly the one above, with no trailing slash.
Consent refused: only an administrator of the organization can approve the connector.

Integrate the HTTP API

You need a Prosperian account and the administrator role in the organization to create a key.

Your key

In the app: Settings, then API & developers (“Paramètres → API et développeurs” in the app). Only administrators can create a key.

Not an administrator? Ask an administrator of your organization.

The secret is shown only once: save it when you create it.

Open Prosperian to create a key Creating a key, step by step (in French)

Your first request

Read-only, with no side effects.
Live keys only: there are no test keys.

bash / zsh

read -rs PROSPERIAN_API_KEY && export PROSPERIAN_API_KEY

Paste your key when the terminal waits, then Enter: it is not echoed and does not stay in your history. Script, CI or agent: set PROSPERIAN_API_KEY in the environment instead.

curl -sS -w '\nHTTP %{http_code}\n' https://app.prosperian.co/api/copilot/stats/list \
  -H "X-API-Key: $PROSPERIAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":1}'

Requires the key step above.

On Windows, import the OpenAPI specification into Postman.

Example response: organization with no campaign

{ "campaigns": [], "limit": 1 }
HTTP 200

This example returns at most one campaign (limit: 1); raise limit to see more. First request in the reference (in French)

If it doesn't work

Read the HTTP status first. The code and ref fields are present on most errors, not all of them.

Status	Cause	What to do
401	Missing, invalid or revoked key.	Check that PROSPERIAN_API_KEY is set in this terminal and that the X-API-Key header is present, then recreate the key if needed.
403	Key from another organization, or a feature not yet opened or not approved for yours.	Read the error message of the response (and the code field when present): it says which case applies, the reference explains what to do.
402	Not enough credits for the requested operation.	Top up your credits, then retry.
500	Server-side error.	Contact support with the time of the call and the ref if the response includes one. Contact support

Error handling (in French)

What the API covers

SourcingFind B2B prospects from a description of your target.Sourcing documentation (in French)
CampaignsCreate a sequence, attach a prospect list to it, activate or pause it.See the endpoint list (in French)
EnrichmentFind the email and phone number of a contact or of a whole list.Enrichment documentation (in French)
StatisticsTrack your campaigns: sends, replies, meetings.See the endpoint list (in French)

Outgoing webhooks

Prosperian can notify your tools (n8n, Make, Zapier) on every event, with a signature to verify. Outgoing notifications (in French)

Resources

Not a customer yet? Launch your agent, the API key is included

Launch my agent for free Book a demo

Free trial · Ready in minutes · Cancel anytime