● Developers

API & MCP documentation

One key powers the REST API and the MCP server — same data, same credit wallet. Search is free; you only pay on reveal.

Quickstart

Base URL

https://leaderra.ai/api

Authentication — pass your key in the header (get one in API & MCP):

curl https://leaderra.ai/api/v1/search \
  -H 'X-API-Key: lk_live_…' \
  -H 'Content-Type: application/json' \
  -d '{ "offer": "…", "icp": "…", "count": 25 }'

REST endpoints

POST/v1/searchFree

Request

{ "offer": "AI churn-prevention platform",
  "icp": "US B2B SaaS, 50–500, VP Customer Success",
  "count": 25 }

Response

{ "records": [ { "name": "…", "title": "…",
     "company": "…", "score": 92, "tier": "Hot" } ],
  "pool": 1240 }

POST/v1/reveal2–19 cr

Request

{ "ref": "<record ref>",
  "fields": ["email","mobile","profile","intel"] }

Response

{ "data": { "email":"…", "mobile":"…",
     "linkedin":"…", "firmo":{…}, "intel":{…} },
  "charged": 19, "balance": 999981 }

GET/v1/signalsvaries

Request

?ref=<saved record or company>

Response

{ "signals": [ { "type":"job_change",
     "detail":"…" } ] }

GET/v1/creditsFree

Request

—

Response

{ "balance": 999981, "plan": "pro" }

MCP server

Drop Leaderra into Claude, Cursor, or any MCP client. Ask in natural language — “Find VP Customer Success at SaaS companies hiring CSMs” — and your agent calls the tools below.

MCP config

{
  "mcpServers": {
    "leaderra": {
      "url": "https://leaderra.ai/api/mcp",
      "headers": { "x-leaderra-key": "lk_live_…" }
    }
  }
}

`leaderra_search`	Find scored hot-signal leads from a prompt or filters (free).
`leaderra_reveal`	Reveal email / mobile / company+person / analysis for a record.
`leaderra_signals`	Job-change, hiring and ad-spend signals for a saved record/company.
`leaderra_credits`	Check the credit balance and plan.

Every REST capability has an MCP tool and vice-versa — the two surfaces stay in sync.

Credit model

Search is free. Reveals are additive and metered: email 2 · mobile 10 · company+person 3 · analysis 4 · full 19. Nothing is charged until you reveal, and never on a miss. See the full cost guide →

Get your API key

One key for REST + MCP, one credit wallet. Free to start.

Get your key 📅 Talk to sales