Leadgen MCP Server

Leadgen MCP — Romanian company data (ONRC, ANAF, financial statements)

A remote Model Context Protocol server for Romania's official business registry: 4.2M firms from ONRC, the ANAF fiscal layer (VAT, e-Factura, fiscal inactivity, phone) and 18 years of financial statements (Ministry of Finance, 2008–2025) with ratios and peer benchmarks.

• Endpoint: https://leadgen-mcp.adrianhomelab.com/mcp (Streamable HTTP)
• Free: 30 lookups a day without a key, 50 a day with a free key from https://leadgen.adrianhomelab.com/start — send it as Authorization: Bearer <key> (or X-API-Key).
• REST API and docs: https://leadgen.adrianhomelab.com/docs · for LLMs: https://leadgen.adrianhomelab.com/llms.txt
• Server card: https://leadgen-mcp.adrianhomelab.com/.well-known/mcp/server-card.json · official MCP registry: com.adrianhomelab/leadgen-onrc

This repository holds the public description of the server and an open-source local MCP client (below). The hosted server's source is not public.

Connect

Claude Code

claude mcp add --transport http leadgen https://leadgen-mcp.adrianhomelab.com/mcp --header "Authorization: Bearer <your key>"

or in .mcp.json:

{
  "mcpServers": {
    "leadgen": {
      "type": "http",
      "url": "https://leadgen-mcp.adrianhomelab.com/mcp",
      "headers": { "Authorization": "Bearer <your key>" }
    }
  }
}

Claude (claude.ai and Claude Desktop): Customize → Connectors → Add custom connector → URL https://leadgen-mcp.adrianhomelab.com/mcp, no sign-in; add the Authorization header with your key if your plan allows custom headers.

Cursor (~/.cursor/mcp.json or .cursor/mcp.json):

{ "mcpServers": { "leadgen": { "url": "https://leadgen-mcp.adrianhomelab.com/mcp", "headers": { "Authorization": "Bearer <your key>" } } } }

VS Code (.vscode/mcp.json):

{ "servers": { "leadgen": { "type": "http", "url": "https://leadgen-mcp.adrianhomelab.com/mcp", "headers": { "Authorization": "Bearer <your key>" } } } }

Without a key every client works for 30 calls a day; get_usage tells you what is left. Current limits: https://leadgen.adrianhomelab.com/en/docs.

Run locally (open client)

The hosted endpoint above is the main product and the simplest way in. If your client only speaks stdio, or you want to run the MCP server yourself, this repository also ships leadgen-mcp: a small open-source (MIT) local MCP server with the same 17 tools. It holds no data: every tool calls Leadgen's public REST API (https://leadgen.adrianhomelab.com/docs), so answers, limits and keys are the same as on the hosted server. Tool names, descriptions and schemas are a snapshot of the hosted server's tools/list (leadgen_mcp/tools.json, refreshed with scripts/sync_tools.py).

It is on PyPI as leadgen-mcp (Python 3.10 or newer):

uvx leadgen-mcp

or install it:

pip install leadgen-mcp
leadgen-mcp

To run the latest commit on main instead of the release: uvx --from git+https://github.com/darksider4all/leadgen-mcp leadgen-mcp.

or run it in Docker: docker build -t leadgen-mcp . then docker run -i --rm -e LEADGEN_API_KEY leadgen-mcp.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "leadgen": {
      "command": "uvx",
      "args": ["leadgen-mcp"],
      "env": { "LEADGEN_API_KEY": "<your key>", "LEADGEN_SOURCE": "claude-desktop" }
    }
  }
}

Cursor (~/.cursor/mcp.json or .cursor/mcp.json):

{
  "mcpServers": {
    "leadgen": {
      "command": "uvx",
      "args": ["leadgen-mcp"],
      "env": { "LEADGEN_API_KEY": "<your key>", "LEADGEN_SOURCE": "cursor" }
    }
  }
}

Leave LEADGEN_API_KEY out to use the REST API's 5 anonymous lookups a day.

How it relates to the hosted server: same tools and same data. This client calls the REST API, whose anonymous allowance is smaller than the MCP endpoint's (5 a day against 30, counted per door and per IP); a free key gives 50 a day. A refusal (no key, daily limit, suspended key) comes back as a tool error that keeps the server's message and the link to a free key; for the daily limit it says when it resets (00:00 UTC). The key is sent as the X-API-Key header, only when it is set. Watches need a key.

Development: pip install -e ".[test]" && pytest (no network); LEADGEN_LIVE=1 pytest tests/test_live.py makes one real anonymous lookup; LEADGEN_DRIFT=1 pytest tests/test_drift.py compares tools.json with the live server card; python scripts/check_public.py checks that nothing private is committed.

Tools

Every company-bearing answer carries asOf (registry snapshot, financial year, ANAF load date) — cite it.

Data and credit

Registry and financial statements: ONRC and the Ministry of Finance via data.gov.ro, licensed CC BY 4.0; fiscal data: ANAF. When you publish data obtained through Leadgen, credit it as: "Sursa: ONRC și Ministerul Finanțelor (data.gov.ro, CC BY 4.0) și ANAF, prin Leadgen".

Romanian

Server MCP pentru registrul oficial al firmelor din România (ONRC, ANAF, bilanțuri 2008–2025). Gratuit: 30 de interogări pe zi fără cheie (5 prin API-ul REST), 50 pe zi cu o cheie gratuită de la https://leadgen.adrianhomelab.com/start. Documentație: https://leadgen.adrianhomelab.com/docs.

Contact

Prices: https://leadgen-checkout.adrianhomelab.com/ · questions: through the website's contact link.