Lead API and MCP server for B2B lead generation

What the anilead API does

What teams use the interfaces for

Three steps to your first request

You need an anilead account with a completed company profile, the API add-on and a balance. You book both under Settings, Billing.

1. 1

   Create a key

   In the app, go to Settings, Integrations and generate a key. Choose “Read-only” for fetching or “Read and write” if searches should be started. The key is shown only once.

2. 2

   Start a search

   Send POST /api/v1/searches with the project id and the number of leads you want. The response contains the id of the search.

3. 3

   Fetch leads

   Once the search has the status completed, GET /api/v1/leads returns the leads with score and reason.

curl -X POST https://anilead.io/api/v1/searches \
  -H "Authorization: Bearer anl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"projectId": "PROJECT_ID", "maxResults": 20}'

curl "https://anilead.io/api/v1/leads?projectId=PROJECT_ID&minScore=70" \
  -H "Authorization: Bearer anl_ro_..."

{
  "leads": [
    {
      "id": "0b7c1f0e-...",
      "score": 86,
      "priority": "high",
      "scoreReason": "Maschinenbauer mit 40 Mitarbeitenden, sucht laut Website ...",
      "company": { "name": "Beispiel GmbH", "website": "https://beispiel.de", "city": "Augsburg" },
      "contact": { "firstName": "Max", "lastName": "Muster", "jobTitle": "Geschäftsführer", "email": "..." }
    }
  ],
  "nextCursor": null
}

REST API: endpoints

Base URL: https://anilead.io/api/v1. Authenticate with the header “Authorization: Bearer” and your key. All responses are JSON.

The full description with all fields and error codes is available as OpenAPI 3.1 and can be loaded into Postman, Insomnia or code generators. /api/v1/openapi.json

MCP server: tools for AI agents

URL: https://anilead.io/api/mcp (Streamable HTTP). The server authenticates with the same key as the REST API. With a read-only key the agent only sees the reading tools.

Connect an agent

The server works with every MCP client that can send an Authorization header.

claude mcp add --transport http anilead https://anilead.io/api/mcp \
  --header "Authorization: Bearer anl_ro_..."

{
  "mcpServers": {
    "anilead": {
      "url": "https://anilead.io/api/mcp",
      "headers": { "Authorization": "Bearer anl_ro_..." }
    }
  }
}

{
  "mcpServers": {
    "anilead": {
      "command": "npx",
      "args": ["mcp-remote", "https://anilead.io/api/mcp",
               "--header", "Authorization: Bearer anl_ro_..."]
    }
  }
}

Sign-in via OAuth, which some web assistants require for custom connectors, is not available at the moment. Use a client with header support there.

Example instruction

“How much balance do I have left? Start a search for 20 leads for my project Mechanical Engineering Bavaria, then show me all leads with a score above 75, each with the reason.”

Pricing

The API add-on has a fixed monthly price. Usage is billed at our actual cost with a fixed markup.

The amount charged for each run is shown in the charged field of the response and in the settings under Billing. All prices exclude VAT.

Security

Limits at a glance

Legal note

The API returns data from public sources, including contact details of business contacts. The same rules apply as in the app: a phone number or email address found here is not permission to contact someone. The GDPR and section 7 of the German Act Against Unfair Competition (UWG) apply. Read the legal notes

Frequently asked questions about the API and MCP