MCP · API

Ask your AI assistant for leads.

IBLead plugs into Claude, ChatGPT, Cursor and other MCP clients. Describe the leads you need in plain language — your assistant searches the database and exports the CSV.

Start free — 200 credits included

200 free credits on signup · no card required

REST API

Same data as the dashboard: 45M+ businesses in 45 countries. Count first at 0 credits, then export as CSV or JSON.

Base URL
https://app.iblead.com/api/v1/
Authentication
Authorization: Bearer sk_live_...

Create a key in the dashboard under API keys, then send it as a Bearer token. API and MCP access needs a credit balance or a plan; the free signup credits count.

Rate limit
120 requests per minute per API key
curl -H "Authorization: Bearer sk_live_..." \
  "https://app.iblead.com/api/v1/businesses?country=FR&category=restaurant&has_email=true&limit=1"
# → {"data": [...], "total": <matching businesses>, "limit": 1, "offset": 0}
# Counting and previewing cost 0 credits.

What you can ask

Type these in your assistant once IBLead is connected.

“Find all restaurants in Paris with an email and more than 50 reviews.”
“Export 500 dentists in Lyon who don't have a website, as a CSV.”
“How many leads did I export today, and what's my credit balance?”
“Create a watch for new hair salons opening in the 75015 area.”
“Look up this Google Maps URL and tell me what you know about the place.”
“What's the coverage for car dealerships in Germany?”

14 tools your assistant can call

Search and preview are free. Only an export debits credits — 1 credit per record.

Search & lookup

read

Filter by country, category, city, email presence, rating or map area. Look up a single place by Google Maps URL, place ID or CID, or up to 100 at once.

Export

export

Run an async export and get the results inline or as a signed CSV link. Poll the job status until it's ready. 1 credit per exported record.

Watches

watches

List your saved searches and their new-match counts, create a new watch (optionally with a webhook), and unlock the new matches when you want them.

Map areas

geo

Build a rectangle or a circle as a polygon so you can search inside a precise zone instead of a whole city.

Works with your assistant

IBLead exposes a standard MCP server over HTTP. Add the URL in your client and connect.

C

Claude

Claude.ai web and Claude Desktop. Add the connector URL and hit Connect.

◐

ChatGPT

Business, Enterprise and Edu workspaces. An admin enables developer mode and adds the URL as a custom app.

⌘

Cursor

Cursor IDE 1.0+. One-click install or paste the URL in mcp.json.

VS

VS Code

VS Code with GitHub Copilot, 1.93+. Add the HTTP server URL.

MCP server URL

https://mcp.iblead.com/mcp

Transport: Streamable HTTP · Auth: OAuth 2.1 with PKCE. You connect with your IBLead account — no API key to copy.

Set up the MCP server in your client

One URL for every client. You sign in with your IBLead account (OAuth), so there is no key to paste.

Claude (web and desktop)

Settings → Connectors → Add custom connector. Paste the URL below, click Add, then Connect and sign in.

https://mcp.iblead.com/mcp

Claude Code (terminal)

Run this command, then type /mcp inside Claude Code and choose Authenticate to sign in with your IBLead account.

claude mcp add --transport http iblead https://mcp.iblead.com/mcp

ChatGPT

Business, Enterprise and Edu workspaces on ChatGPT web. A workspace admin turns on developer mode, then adds the URL as a custom app.

https://mcp.iblead.com/mcp

Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), then sign in when Cursor asks.

{
  "mcpServers": {
    "iblead": {
      "url": "https://mcp.iblead.com/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Add this to .vscode/mcp.json in your workspace, then start the server and sign in.

{
  "servers": {
    "iblead": {
      "type": "http",
      "url": "https://mcp.iblead.com/mcp"
    }
  }
}

Counts and previews cost 0 credits. From €4.40 per 1,000 records on Starter. 1 credit = 1 exported record, 200 free credits at signup. API and MCP access needs a credit balance or a plan.

Create a free account and get an API key

How it works

1

Create a free account

Sign up and get 200 credits. No card required.

2

Connect your assistant

Add the MCP server URL in Claude, ChatGPT, Cursor or VS Code and authorize with your account.

3

Ask in plain language

Your assistant searches the database and exports the CSV. Counts and previews cost 0 credits while your account has credits or a plan; exports use credits.

Questions

No. You connect IBLead once in your assistant, then ask for leads in plain language. The HTTP API is also available if you prefer to script it.
Searching and previewing are free. Exporting debits 1 credit per record, the same as the dashboard. A free account includes 200 credits.
Any client that speaks the Model Context Protocol over HTTP — including Claude, ChatGPT (Business/Enterprise), Cursor and VS Code with GitHub Copilot.
Yes. The assistant queries the same database — 45M+ businesses across 45 countries, with emails, phones, websites and SIRET for France.

Connect IBLead to your assistant

Create a free account and add the MCP server in a couple of minutes.

Start free — 200 credits included