Reference
LeadMCP API
The LeadMCP API finds people and companies, enriches them with verified contact details, and exports the results. Every route returns JSON. Every route uses the same API key.
Base URL
Send every request to this origin.
https://leadmcp.ai
Authentication
Create a key in the app, then send it on every request. Pick one header form per request.
| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | required | Your key, in the form lb_live_YOUR_API_KEY. |
Authorization | string | alternative | The same key as Bearer lb_live_YOUR_API_KEY. |
A revoked or missing key returns 401. The health route needs no key.
Rate limits
Accounts start at 100 requests per minute across all routes. Requests above that return 429.
Back off and retry after a short pause. Batch routes accept up to 100 items per request, so you rarely need a higher rate.
Ask us to raise the limit on your account if you integrate at higher volume.
Errors
| Status | Meaning |
|---|---|
400 | Invalid body, invalid CSV shape, or a batch above the limit. |
401 | Missing, malformed, or revoked API key. |
402 | Not enough plan credits, or an export limit reached. |
429 | Rate limit exceeded. Back off and retry. |
502 | An enrichment provider failed or timed out. |
503 | The contact database is unavailable. |
Use with an AI agent
The whole reference is one markdown file. Give the URL to Claude, Cursor, ChatGPT or any agent, and it can read every route in one request.
https://leadmcp.ai/llms-full.txt
Paste this prompt to start.
Read https://leadmcp.ai/llms-full.txt. It is the full LeadMCP API reference. Use it to call the API on my behalf.A short index lives at https://leadmcp.ai/llms.txt.