Everything the hosted MCP server does, as plain HTTPS and JSON for pipelines, backends and scripts. Same API key, same credits. Agents can keep using https://mcp.descovo.com/mcp.
Basics
Base URL
https://api.descovo.com/v1
Auth
Authorization: Bearer <key> (or an x-api-key header). Create keys on the API Keys page.
Format
JSON request bodies on POST; every response is JSON.
Billing
Each response says what it charged in credits.charged (and the balance in credits.available when reported). Counts and the balance are free.
{
"error": {
"code": "unauthorized",
"message": "Send your API key in the x-api-key header (or Authorization: Bearer <key>). Create one at https://descovo.com/app/keys."
}
}
400invalid_request / invalid_jsonThe body doesn’t match the route. fields lists each problem.
401unauthorizedNo key, or a key that was revoked.
402insufficient_creditsOut of credits. Top up or change plan on the Billing page.
404not_foundNo such route. GET /v1 lists them all.
429rate_limitedToo fast. Read x-ratelimit-reset and retry after it.
Search
POST/v1/people/searchSearch people
Filter by title, company, seniority, function, industry, location and more. Put the company in top-level currentCompanies so the title must hold at that same job. Pages with a cursor.
Describe who you want; Descovo turns it into filters and runs the search.
Cost: 2 credits + 1 per result
POST /v1/people/ask
curl -X POST https://api.descovo.com/v1/people/ask \
-H "Authorization: Bearer $DESCOVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Heads of data at fintech companies in New York","pageSize":10}'
POST/v1/companies/askAsk in plain English (companies)
Same, for companies.
Cost: 2 credits + 1 per result
Contacts
POST/v1/contacts/revealReveal email and phone
Work email, personal email and direct phone for a LinkedIn profile. Charged only for fields found. Add "mode": "lite" or "turbo" for the other reveal depths.
Cost: 2 per work email, 3 per phone, 5 for both (lite: 1 per field)
POST/v1/contacts/reveal/batchReveal a list of people
Send up to 2,000 LinkedIn URLs and get their emails and phones back. Returns a taskId right away and runs in the background; charged per unique person, and anything not found is refunded when the task finishes.
Cost: 2 per work email, 3 per phone, 5 for both — per person found, misses refunded