How to write the first outreach message in an AI SDR agent with MCP

What does Prosp give my agent for the first message?

Prosp (prosp.cc) runs an MCP server that composes the first outreach message for one recipient company, and your agent uses it as the writing step after it has picked a company to contact. Prosp composes the text. It does not send it. Your agent or your user sends it.

The message is grounded in facts. It states as fact only what Prosp holds a source for, about the recipient company and about the seller. Personal data is never stated. Where Prosp has no source, the message does not claim the fact.

Your agentYour agentProsp MCP serverProsp MCP serverset_seller_profile: businessdescription and websiteProfile saved, no creditsgenerate_message: recipientdomainGeneration registered atonce, credits debitedResearch if unknown(enriching), then composeget_message_generation: polluntil it endsStatus, then the finishedmessagecancel_message_generation:only if not finished
The agent saves the profile once, registers one generation per company, polls until it ends, and reads the message.

How do I connect the agent and save the seller profile?

Point the agent at the remote MCP server https://api.prosp.cc/mcp-rpc (no trailing slash). It uses Streamable HTTP. Signing in opens a window in the agent, so there are no API keys to paste.

Then call set_seller_profile once with the seller's business description and website. These ground every message the agent writes. The call costs no credits. get_seller_profile shows the saved profile and whether an offering was derived from the website. delete_seller_profile removes it. Both cost no credits.

How do I start a message for one company?

Call generate_message with the recipient company's domain, one call per recipient. It registers the generation and returns at once. The message is composed in the background, so keep what the call returns and use it in the next step. The example below shows the REST form of the request and Prosp's answer.

The call debits ten credits once, when the generation is registered. The domain does not have to belong to a company Prosp found for you. If Prosp does not know the company yet, it researches the company first. The generation then passes through the status enriching, and the message is composed after that. The research is covered by the same single debit.

Write an e-mail for one company (Smart Messaging, JavaScript)
const res = await fetch("https://api.prosp.cc/api/v1/message-intelligence", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    "objective": "Offer a short list of cafes and restaurants in Germany that buy specialty coffee wholesale, and ask whether a sample list would help.",
    "recipient": {
      "name": "Team",
      "company_domain": "hesselinkkoffie.nl"
    },
    "channel": "email",
    "sender": {
      "company_domain": "prosp.cc"
    }
  }),
});
const { id } = await res.json();   // 202: the message is written in the background
const deadline = Date.now() + 45 * 60 * 1000;
let gen;
do {
  await new Promise((r) => setTimeout(r, 5_000));
  if (Date.now() > deadline) throw new Error("the message was not written in 45 minutes");
  const r = await fetch(`https://api.prosp.cc/api/v1/message-intelligence/${id}`, {
    headers: { Authorization: `Bearer ${accessToken}` },
  });
  if (!r.ok) throw new Error(`message status check failed: HTTP ${r.status}`);
  gen = await r.json();
} while (!["succeeded", "failed", "canceled"].includes(gen.status));
console.log(gen.result.subject, gen.result.message);
What Prosp answered (HTTP 202)
{
  "id": "81648e2731934d9a2677b517efaa60b0",
  "status": "queued"
}

How do I wait for the message and read it?

Call get_message_generation with the generation you registered. Repeat the call until the generation ends. The status tells you where it is, for example enriching while Prosp researches an unknown company. Once the generation has succeeded, the same call returns the finished message. The response below shows the message with some of the facts it used.

Read the message and hand it to whatever sends it. A generation is kept for seven days after it ends, so read it within that time. If the generation failed, the agent should log it and decide whether to register a new one. A failed generation returns its credits.

The finished message (three of the facts it used shown)
{
  "status": "succeeded",
  "created_at": "2026-11-09T01:27:20.020245721Z",
  "expires_at": "2026-11-16T01:29:03.562634777Z",
  "id": "81648e2731934d9a2677b517efaa60b0",
  "last_updated_at": "2026-11-09T01:29:03.562634777Z",
  "result": {
    "subject": "Potentiële afnemers voor Hesselink Koffie in Duitsland",
    "angle": "Lead generation for German hospitality market",
    "message": "Geachte heer/mevrouw,\n\nHesselink Koffie levert duurzame koffieoplossingen aan de horeca en zakelijke sectoren in onder andere Duitsland. Zou het voor u waardevol zijn om een voorbeeldlijst van deze bedrijven te ontvangen?\n\nMet vriendelijke groet,\n\nProsp",
    "facts_used": [
      {
        "fact_id": "name",
        "text": "Hesselink Koffie",
        "tier": "reported",
        "field": "name",
        "as_of": "2026-11-04"
      },
      {
        "source_url": "https://hesselinkkoffie.nl/over-ons/duurzaamheid/",
        "fact_id": "kb_fact",
        "text": "Hesselink Koffiebranders maintains transparency throughout their supply chain and holds multiple certifications including Fairtrade Organic, SKAL for organic production, and the Rainforest Alliance seal.",
        "tier": "reported",
        "field": "kb_fact",
        "as_of": "2026-11-04"
      },
      {
        "source_url": "https://hesselinkkoffie.nl/over-ons/duurzaamheid/",
        "fact_id": "kb_fact",
        "text": "Hesselink Koffiebranders is an officially B Corp certified coffee supplier that provides sustainable coffee solutions to the hospitality industry and other business sectors.",
        "tier": "reported",
        "field": "kb_fact",
        "as_of": "2026-11-04"
      }
    ],
    "facts_missing": [
      "registry",
      "events_town",
      "trade_fair"
    ]
  }
}

What happens to credits if a generation fails or I cancel it?

A failed generation returns the credits it debited.

To stop a generation that has not finished, call cancel_message_generation. Credits come back only if composition had not started. Once composition has started, a cancel does not return them.

What is the one thing to do next?

Connect your agent over MCP with the button below. It can then send its first request and get a message back for a company.

Connect your agent