Quick-start: your first discovery with curl

You need a Client ID and a Client Secret. Open the Telegram bot @prosp_mcp_credits_bot, send /start, buy credits with /buy, then send /credentials.

Start in Telegram

1. Exchange the credentials for a Bearer token. TOKEN_URL is the tokenUrl under components.securitySchemes in the OpenAPI spec; the only supported grant is client_credentials.

TOKEN=$(curl -s -X POST "$TOKEN_URL" \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d scope=mcp/execute | jq -r .access_token)

2. Start a discovery. It debits 100 credits. X-Idempotency-Key is required and makes a retry safe. Only query is required in the body.

curl -s -X POST 'https://api.prosp.cc/api/v1/discoveries' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -H "X-Idempotency-Key: $(uuidgen)" \
  -d '{
    "query": "Independent menswear retailers with their own online shop",
    "industries": ["Retail", "Fashion"],
    "locations": ["Germany", "Austria"],
    "company_sizes": ["small", "medium"],
    "maxResults": 10
  }'
# => {"jobId": "...", "status": "queued", ...}

3. Poll the job. A run typically takes 5–25 minutes; the answer carries the companies once the status is terminal.

curl -s "https://api.prosp.cc/api/v1/discoveries/$JOB_ID" \
  -H "Authorization: Bearer $TOKEN"

Prefer an AI agent? See the MCP setup. Every field is in the reference below.