So führt ein KI-SDR-Agent über MCP eine B2B-Suche aus, die Minuten dauert

Warum dauert eine Suche Minuten, und was bekommt der Agent?

Prosp gibt Ihrem SDR-Agenten eine Liste möglicher Kunden, jedes Unternehmen mit den Kontaktdaten, die Prosp gefunden hat. Der Agent kann sie als den Schritt nutzen, der klärt, wen er anschreibt. Eine Suche dauert Minuten, weil die Website jedes Kandidaten besucht und abgeglichen wird, bevor das Unternehmen zurückgegeben wird.

Der Agent wartet deshalb nicht an einem offenen Aufruf. Er startet einen Auftrag, fragt ihn ab und liest das Ergebnis, wenn der Auftrag beendet ist. Unternehmen, die Prosp schon kennt, können in Sekunden zurückkommen.

Ihr AgentIhr AgentProsp-MCP-ServerProsp-MCP-Serverfind_prospects: Kriterienfür die ZielkundenjobId, sofort zurückgegebenget_discovery_status: jobIdund CursorStatus, Unternehmen bisher,neue Domains, next_cursorget_discovery_results:jobId, Auftrag ist beendetZusammenfassung und Unternehmenmit Ansprechpartnerncancel_discovery: jobId, nurzum vorzeitigen Stoppen
Der Agent startet den Auftrag, fragt mit dem Cursor ab, bis er endet, liest die Ergebnisse und bricht nur ab, wenn er vorzeitig stoppen will.

Schritt eins: Wie startet der Agent den Auftrag?

Rufen Sie das MCP-Werkzeug find_prospects mit den Kriterien auf: eine Anfrage in natürlicher Sprache, dazu wahlweise Branchen, Standorte, Unternehmensgrößen, Stichwörter, Ausschlüsse, Regionen innerhalb eines Landes und Geschäftsmodelle. Über REST ist derselbe Start POST /mcp/tools/execute oder POST /api/v1/discoveries für eine ICP-ID oder Kriterien direkt in der Anfrage. Eine Suche kostet 100 Credits.

Die aufgezeichnete Anfrage unten lautet: Independent coffee roasters in the Netherlands that supply cafes and restaurants. Prosp antwortet sofort mit einer jobId. Der Auftrag läuft danach asynchron, in der Regel fünf bis fünfundzwanzig Minuten. Speichern Sie die jobId; jeder spätere Aufruf braucht sie.

Eine Suche starten (REST, JavaScript)
// accessToken: exchange your Client ID and Secret (/credentials in the bot) for a token with the OAuth client-credentials grant; the token URL is in /docs/
// idempotencyKey: make ONE per run and reuse it when a step is retried, so a retry never starts a second paid job
const res = await fetch("https://api.prosp.cc/api/v1/discoveries", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
    "X-Idempotency-Key": idempotencyKey,
  },
  body: JSON.stringify({
    "query": "Independent coffee roasters in the Netherlands that supply cafes and restaurants",
    "locations": [
      "Netherlands"
    ],
    "company_sizes": [
      "small",
      "medium"
    ],
    "maxResults": 5
  }),
});
if (!res.ok) throw new Error(`start failed: HTTP ${res.status}`);   // 402 no credits; 409 a warning or the same job already running (nothing charged); 429 too many requests or jobs
const { jobId } = await res.json();
Was Prosp geantwortet hat (HTTP 200)
{
  "jobId": "5fd86ce778c25261e522b4f516ae6c1c",
  "status": "running",
  "createdAt": "2026-11-09T01:26:49.070978327Z",
  "poll_after_seconds": 20,
  "estimated_duration_seconds": 3605,
  "estimated_duration_p50_seconds": 116,
  "estimated_duration_p90_seconds": 2589,
  "estimated_duration_p95_seconds": 3605,
  "estimated_yield": 3
}

Schritt zwei: Wie fragt der Agent einen laufenden Auftrag ab?

Rufen Sie get_discovery_status mit der jobId auf. Der Aufruf meldet den Status des Auftrags, die Zahl der bisher gefundenen Unternehmen und das Ziel. Er listet auch die gefundenen Domains auf; sie kommen nach und nach hinzu, während der Auftrag läuft. Übergeben Sie den vorherigen next_cursor als cursor, dann erhalten Sie nur die neuen Domains. Das Abfragen kostet keine Credits.

Über REST fragen Sie GET /mcp/jobs/{jobId}/status ab. Die Antwort enthält den Status, die bisher gefundenen Unternehmen, das Ziel, die gefundenen Domains, next_cursor und die Wartezeit bis zur nächsten Abfrage. Warten Sie so lange, fragen Sie dann erneut ab und übergeben Sie den zuletzt erhaltenen next_cursor als Parameter cursor. Fragen Sie weiter ab, bis der Status einer der unten beschriebenen Endzustände ist.

Eine Suche, die noch läuft
{
  "next_cursor": "MA",
  "poll_after_seconds": 20,
  "has_more": true,
  "prospectsFound": 0,
  "stage": "searching",
  "candidates_screened": 0,
  "estimated_duration_p50_seconds": 116,
  "total_prospects": 0,
  "estimated_duration_p90_seconds": 2589,
  "estimated_duration_p95_seconds": 3605,
  "estimated_duration_seconds": 3605,
  "estimated_yield": 3,
  "evaluated_count": 0,
  "jobId": "5fd86ce778c25261e522b4f516ae6c1c",
  "status": "processing",
  "target": 5
}
Auf die Suche warten (REST, JavaScript)
// accessToken and jobId: from the calls above
const terminal = ["completed", "failed", "exhausted", "cancelled"];
const deadline = Date.now() + 45 * 60 * 1000;
let job, cursor = null, wait = 20;   // seconds; then the poll_after_seconds of the last answer
do {
  await new Promise((r) => setTimeout(r, wait * 1000));
  if (Date.now() > deadline) {
    await fetch(`https://api.prosp.cc/mcp/jobs/${jobId}/cancel`, {
      method: "POST",
      headers: { Authorization: `Bearer ${accessToken}` },
    });   // frees the concurrency slot; prospects already delivered are kept
    throw new Error("the job did not finish in 45 minutes and was cancelled");
  }
  const url = `https://api.prosp.cc/mcp/jobs/${jobId}/status` + (cursor ? `?cursor=${encodeURIComponent(cursor)}` : "");
  const r = await fetch(url, {
    headers: { Authorization: `Bearer ${accessToken}` },
  });
  if (!r.ok) throw new Error(`status check failed: HTTP ${r.status}`);
  job = await r.json();
  cursor = job.next_cursor ?? cursor;   // only the prospects added since the last poll
  wait = job.poll_after_seconds ?? 20;
} while (!terminal.includes(job.status));

Schritt drei: Wie liest der Agent die Unternehmen?

Sobald der Auftrag beendet ist, rufen Sie get_discovery_results auf. Der Aufruf liefert die Ergebnisübersicht und die Unternehmen mit den Kontaktdaten, die Prosp gefunden hat. Über REST lesen Sie die Unternehmen mit GET /api/v1/discoveries/{jobId}/prospects. Das Lesen der Ergebnisse kostet keine Credits.

Zu jedem Unternehmen gehören Ansprechpartner, die auf seiner eigenen Website und an anderer Stelle im öffentlichen Web gefunden wurden. Bei einem Ansprechpartner stehen Name, Position, E-Mail, Telefon und Social-Media-Profile, soweit sie veröffentlicht sind. Die Seite, auf der er gefunden wurde, wird nicht angezeigt, und eine E-Mail-Adresse, die Prosp abgeleitet und nicht gefunden hat, ist als abgeleitet gekennzeichnet. Das öffentliche Beispiel unten lässt die Ansprechpartner absichtlich weg; die Feldliste zeigt, was zu jedem Ansprechpartner gehört.

Die Unternehmen abrufen (REST, JavaScript)
// accessToken and jobId: from the calls above
const r = await fetch(`https://api.prosp.cc/api/v1/discoveries/${jobId}/prospects`, {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const { prospects } = await r.json();
Die Unternehmen, die Prosp geliefert hat (zwei gezeigt; Kontakte sind in diesem öffentlichen Beispiel ausgelassen)
{
  "already_owned_count": 1,
  "candidates_screened": 39,
  "prospects": [
    {
      "country_code": "NL",
      "city": "Winterswijk",
      "state": "Gelderland",
      "linkedin_url": "https://www.linkedin.com/company/hesselink-koffie/",
      "instagram_url": "https://www.instagram.com/hesselinkkoffiebranders/",
      "facebook_url": "https://www.facebook.com/hesselinkKoffie",
      "youtube_url": "https://youtube.com/@HesselinkKoffie",
      "business_model": "manufacturer",
      "estimated_annual_revenue_usd": 24000000,
      "domain": "hesselinkkoffie.nl",
      "industry": "Agriculture & Food Production",
      "estimated_revenue_currency": "USD",
      "founded_year": 1885,
      "hq_address": "Winterswijk, Gelderland, Netherlands",
      "social_description": "Hesselink Koffiebranders ( B Corp) \nis een familiebedrijf dat sinds 1885 staat voor topkwaliteit en duurzaamheid in koffie. Met meer dan 140 jaar ervaring beheersen we het ambacht van koffiebranden als geen ander. Onze passie voor perfectie zorgt ervoor dat elke kop koffie een moment van geluk is.",
      "social_follower_count": 2691,
      "social_legal_name": "Hesselink Koffie",
      "social_source": "linkedin",
      "social_extra_links": [
        "http://www.hesselinkkoffie.eu",
        "https://plus.google.com/113443696654761814245/posts",
        "https://www.facebook.com/hesselinkKoffie?fref=ts",
        "https://twitter.com/HesselinkKoffie",
        "http://www.linkedin.com/company/1043333?trk=tyah&trkInfo=tas%3Ahesselink%20koffie%2Cidx%3A1-1-1",
        "http://www.fingerprinted.eu",
        "http://www.hespresso.eu"
      ],
      "social_profiles": [
        {
          "platform": "linkedin",
          "url": "https://www.linkedin.com/company/hesselink-koffie/",
          "follower_count": 2691,
          "legal_name": "Hesselink Koffie"
        },
        {
          "platform": "youtube",
          "url": "https://youtube.com/@HesselinkKoffie",
          "follower_count": 78,
          "extra_links": [
            "http://www.hesselinkkoffie.eu",
            "https://plus.google.com/113443696654761814245/posts",
            "https://www.facebook.com/hesselinkKoffie?fref=ts",
            "https://twitter.com/HesselinkKoffie",
            "http://www.linkedin.com/company/1043333?trk=tyah&trkInfo=tas%3Ahesselink%20koffie%2Cidx%3A1-1-1",
            "http://www.fingerprinted.eu",
            "http://www.hespresso.eu"
          ],
          "legal_name": "Hesselink Koffie",
          "description": "Wij zijn Hesselink Koffie en wij geloven dat lekkere koffie een leven kan verrijken. Voor de meeste Nederlanders is koffie een primaire levensbehoefte. Onze missie is iedereen met die behoefte van dienst te zijn. Dit doen wij vanuit onze eigen koffiebranderij in Winterswijk, zo kunnen wij ambachtelijke en bovenal lekkere koffie garanderen.\n\nWij leveren koffie aan: horeca, bedrijven en particulieren (Hespresso). Daarnaast hebben wij ook ons eigen label duurzame koffie: Fingerprinted Koffie."
        }
      ],
      "discovered_at": "2026-11-04T11:56:49.888716Z",
      "detected_language": "nl",
      "has_wikipedia_article": true,
      "detected_industry": "Agriculture & Food Production",
      "origin_country": "NL",
      "facts": [
        {
          "source": "web",
          "source_url": "https://hesselinkkoffie.nl/over-ons/duurzaamheid/",
          "extracted_at": "2026-11-04T12:03:30.815668Z",
          "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.",
          "first_party": true
        },
        {
          "source": "web",
          "source_url": "https://hesselinkkoffie.nl/over-ons/duurzaamheid/",
          "extracted_at": "2026-11-04T12:03:30.531299Z",
          "text": "Hesselink Koffiebranders is an officially B Corp certified coffee supplier that provides sustainable coffee solutions to the hospitality industry and other business sectors.",
          "first_party": true
        }
      ],
      "name": "Hesselink Koffie",
      "description": "Hesselink Koffie is a coffee roastery providing artisanal, sustainably sourced coffee beans and professional coffee machines. They serve hospitality and corporate clients primarily across the Netherlands and Germany.",
      "employee_count": 40,
      "company_size": "small",
      "employee_count_source": "unverified_estimate",
      "employee_count_as_of": "2026-11-04T11:56:49.888716Z",
      "size_certainty": "estimated",
      "headquarters_location": "Winterswijk, Netherlands",
      "country": "Netherlands"
    },
    {
      "country_code": "NL",
      "city": "Noordwijkerhout",
      "state": "Zuid-Holland",
      "postal_code": "2211",
      "street": "Pletterij 7",
      "instagram_url": "https://www.instagram.com/koffie_lovers/",
      "facebook_url": "https://www.facebook.com/KoffieLoverss",
      "business_model": "manufacturer",
      "estimated_annual_revenue_usd": 4400000,
      "domain": "koffie-lovers.nl",
      "industry": "Hospitality & Restaurant",
      "estimated_revenue_currency": "USD",
      "founded_year": 1998,
      "hq_address": "Pletterij 7, Noordwijkerhout, Zuid-Holland 2211, Netherlands",
      "discovered_at": "2026-11-04T11:55:22.190906Z",
      "detected_language": "nl",
      "has_wikipedia_article": false,
      "domain_age_days": 4963,
      "detected_industry": "Hospitality & Restaurant",
      "sub_country_region": "NL-ZH",
      "origin_country": "NL",
      "facts": [
        {
          "source": "web",
          "source_url": "https://grachtenbeans.nl/en/koffiebrander/koffie-lovers/",
          "extracted_at": "2026-11-04T11:59:04.202460Z",
          "text": "Koffie Lovers has built a strong brand by combining craft roasting techniques, ethical sourcing, and educational efforts despite having fewer than ten employees.",
          "first_party": false
        },
        {
          "source": "web",
          "source_url": "https://grachtenbeans.nl/en/koffiebrander/koffie-lovers/",
          "extracted_at": "2026-11-04T11:57:39.551192Z",
          "text": "The company offers a range of seven house blends and several single-origin coffees sourced directly from twelve countries, all carrying Fairtrade or Rainforest Alliance certifications.",
          "first_party": false
        }
      ],
      "name": "Koffie Lovers",
      "description": "Koffie Lovers is a coffee roasting business that supplies freshly roasted coffee beans, espresso machines, and accessories to hospitality businesses and offices throughout the Netherlands.",
      "employee_count": 15,
      "company_size": "small",
      "employee_count_source": "unverified_estimate",
      "employee_count_as_of": "2026-11-04T11:55:22.190906Z",
      "size_certainty": "estimated",
      "headquarters_location": "Noordwijkerhout, Netherlands",
      "country": "Netherlands"
    }
  ],
  "evaluated_count": 7,
  "total": 5
}
Die Felder jedes Kontakts (nur die Feldnamen)
[
  "name",
  "email",
  "position",
  "phone",
  "department",
  "organization",
  "linkedin_url",
  "instagram_url",
  "facebook_url",
  "twitter_url",
  "youtube_url",
  "telegram_url",
  "viber_url",
  "whatsapp_url",
  "contact_address",
  "contact_city",
  "contact_country",
  "contact_country_code",
  "contact_region",
  "registry_source",
  "email_source",
  "is_officer"
]

Wie endet ein Auftrag, und wie bricht der Agent ihn ab?

Ein Auftrag endet in genau einem Status:

Ein Auftrag, der fehlschlägt, bevor er etwas geliefert hat, oder der unter dem Ziel endet, weil die Quellen erschöpft waren oder seine Zeit abgelaufen ist, wird vollständig gutgeschrieben.

Um einen laufenden Auftrag zu stoppen, rufen Sie cancel_discovery auf, über REST POST /mcp/jobs/{jobId}/cancel. Ein abgebrochener Auftrag behält die Unternehmen, die er schon geliefert hat. Credits werden nur gutgeschrieben, wenn zum Zeitpunkt des Abbruchs noch nichts geliefert war.

Die abgeschlossene Suche (zwei Unternehmen gezeigt)
{
  "status": "completed",
  "jobId": "5fd86ce778c25261e522b4f516ae6c1c",
  "result": {
    "prospects": [
      {
        "social_description": "Born from adventure, we now have over 20 years of proud heritage that gives us the edge of unparalleled quality, experience and craftmanship. It’s the way we see the future while celebrating our past that allows us to lead the way in our favorite game. And we do it right.",
        "social_follower_count": 3574,
        "social_legal_name": "Bocca Coffee",
        "social_source": "linkedin",
        "social_profiles": [
          {
            "legal_name": "Bocca Coffee",
            "platform": "linkedin",
            "url": "https://www.linkedin.com/company/bocca-coffee/",
            "follower_count": 3574
          },
          {
            "legal_name": "Bocca Coffee",
            "platform": "youtube",
            "url": "https://www.youtube.com/@boccacoffee3009",
            "follower_count": 99
          }
        ],
        "discovered_at": "2026-11-04T12:05:42.480277Z",
        "detected_language": "nl",
        "has_wikipedia_article": false,
        "domain_age_days": 8918,
        "detected_industry": "Hospitality & Restaurant",
        "sub_country_region": "NL-NH",
        "origin_country": "NL",
        "facts": [
          {
            "first_party": true,
            "text": "The company serves a wide variety of commercial clients, including restaurants, hotels, cafés, bakeries, offices, and sports clubs, providing B2B services such as private label production, contract roasting, and coffee supply solutions.",
            "source_url": "https://bocca.nl",
            "source": "web",
            "extracted_at": "2026-11-04T12:27:13.370758Z"
          },
          {
            "first_party": true,
            "text": "Founder Menno Simons established the company, which maintains a vertically integrated business model covering sourcing, roasting, brewing, training, and serving, supported by a passionate, talented, and family-like team that emphasizes continuous improvement.",
            "source_url": "https://bocca.nl/en/blogs/vacancies",
            "source": "web",
            "extracted_at": "2026-11-04T12:33:25.229089Z"
          }
        ],
        "name": "Bocca Espresso Bar",
        "description": "Bocca Espresso Bar sells specialty coffee, coffee machines, and related services primarily to hospitality businesses and offices in the Netherlands. They focus on direct trade, roasting, and packaging to deliver high-quality coffee experiences.",
        "employee_count": 37,
        "company_size": "small",
        "employee_count_source": "unverified_estimate",
        "employee_count_as_of": "2026-11-04T12:05:42.480277Z",
        "size_certainty": "estimated",
        "headquarters_location": "Amsterdam, Netherlands",
        "country": "Netherlands",
        "country_code": "NL",
        "city": "Amsterdam",
        "state": "Noord-Holland",
        "postal_code": "1017 GP",
        "street": "Kerkstraat 96H",
        "linkedin_url": "https://www.linkedin.com/company/bocca-coffee/",
        "instagram_url": "https://www.instagram.com/boccacoffee/?hl=nl",
        "facebook_url": "https://www.facebook.com/BoccaCoffee",
        "youtube_url": "https://www.youtube.com/@boccacoffee3009",
        "business_model": "manufacturer",
        "domain": "bocca.nl",
        "industry": "Hospitality & Restaurant",
        "estimated_annual_revenue_usd": 11000000,
        "estimated_revenue_currency": "USD",
        "founded_year": 2001,
        "web_traffic": {
          "history": [
            {
              "dateFrom": "2026-05",
              "dateTo": "2026-05",
              "value": 7494
            },
            {
              "dateFrom": "2026-06",
              "dateTo": "2026-06",
              "value": 17259
            },
            {
              "dateFrom": "2026-07",
              "dateTo": "2026-07",
              "value": 9393
            },
            {
              "dateFrom": "2026-08",
              "dateTo": "2026-08",
              "value": 7773
            },
            {
              "dateFrom": "2026-09",
              "dateTo": "2026-09",
              "value": 9268
            },
            {
              "dateFrom": "2026-10",
              "dateTo": "2026-10",
              "value": 9268
            }
          ],
          "countryRank": 54331,
          "visitsMonthly": 9268,
          "avgDurationSeconds": 45
        },
        "hq_address": "Kerkstraat 96H, Amsterdam, Noord-Holland 1017 GP, Netherlands"
      },
      {
        "discovered_at": "2026-11-04T11:55:22.190906Z",
        "detected_language": "nl",
        "has_wikipedia_article": false,
        "domain_age_days": 4963,
        "detected_industry": "Hospitality & Restaurant",
        "sub_country_region": "NL-ZH",
        "origin_country": "NL",
        "facts": [
          {
            "first_party": false,
            "text": "Koffie Lovers has built a strong brand by combining craft roasting techniques, ethical sourcing, and educational efforts despite having fewer than ten employees.",
            "source_url": "https://grachtenbeans.nl/en/koffiebrander/koffie-lovers/",
            "source": "web",
            "extracted_at": "2026-11-04T11:59:04.202460Z"
          },
          {
            "first_party": false,
            "text": "The company offers a range of seven house blends and several single-origin coffees sourced directly from twelve countries, all carrying Fairtrade or Rainforest Alliance certifications.",
            "source_url": "https://grachtenbeans.nl/en/koffiebrander/koffie-lovers/",
            "source": "web",
            "extracted_at": "2026-11-04T11:57:39.551192Z"
          }
        ],
        "name": "Koffie Lovers",
        "description": "Koffie Lovers is a coffee roasting business that supplies freshly roasted coffee beans, espresso machines, and accessories to hospitality businesses and offices throughout the Netherlands.",
        "employee_count": 15,
        "company_size": "small",
        "employee_count_source": "unverified_estimate",
        "employee_count_as_of": "2026-11-04T11:55:22.190906Z",
        "size_certainty": "estimated",
        "headquarters_location": "Noordwijkerhout, Netherlands",
        "country": "Netherlands",
        "country_code": "NL",
        "city": "Noordwijkerhout",
        "state": "Zuid-Holland",
        "postal_code": "2211",
        "street": "Pletterij 7",
        "instagram_url": "https://www.instagram.com/koffie_lovers/",
        "facebook_url": "https://www.facebook.com/KoffieLoverss",
        "business_model": "manufacturer",
        "domain": "koffie-lovers.nl",
        "industry": "Hospitality & Restaurant",
        "estimated_annual_revenue_usd": 4400000,
        "estimated_revenue_currency": "USD",
        "founded_year": 1998,
        "hq_address": "Pletterij 7, Noordwijkerhout, Zuid-Holland 2211, Netherlands"
      }
    ],
    "already_owned_count": 1,
    "candidates_screened": 39,
    "status": "completed",
    "total_prospects": 5,
    "completed_at": "2026-11-09T01:27:05.003Z",
    "terminal_reason": "target_reached",
    "evaluated_count": 7,
    "already_owned_withheld_count": 5,
    "jobId": "5fd86ce778c25261e522b4f516ae6c1c"
  }
}

Was sollten Sie als Nächstes tun?

Verbinden Sie Ihren Agenten über die Button unten per MCP. Danach kann er seine erste find_prospects-Anfrage senden und erhält Unternehmen zurück.

Fragen

Welche REST-Route liefert nur den Status eines Auftrags und seine Übersicht?

GET /api/v1/discoveries/{jobId} liefert den Status und, sobald der Auftrag beendet ist, die Ergebnisübersicht. Die Unternehmen listet sie nicht auf; dafür gibt es die prospects-Route.

Kann der Agent Unternehmen, die er schon gefunden hat, noch einmal ansehen?

Ja. search_prospects führt eine semantische Freitextsuche über bereits gefundene Unternehmen aus, und get_prospect liefert den vollständigen Datensatz zu einer Domain. acknowledge_prospects markiert Domains als geliefert, damit sie nicht noch einmal zurückgegeben werden. Alle drei kosten keine Credits.

Assistenten verbinden