Skip to main content
Glama

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

mcptry Leadgen ONRC Romania MCP on mcprush Leadgen ONRC Romania MCP server MCP Badge Apify Actor

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.

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.

Related MCP server: openregistry

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-api.adrianhomelab.com/en/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.

Variable

Default

What it does

LEADGEN_API_KEY

none

Your free key from https://leadgen.adrianhomelab.com/start (50 lookups a day instead of the REST API's 5). Optional; sent only when set.

LEADGEN_SOURCE

glama

A channel tag sent with each request (X-Leadgen-Source header and src parameter), so Leadgen knows where its users come from.

LEADGEN_API_URL

https://leadgen.adrianhomelab.com

REST API base URL.

LEADGEN_TIMEOUT

60

Seconds to wait for an answer (website crawls can take a while).

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 (midnight Romanian time, 00:00 Europe/Bucharest). 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

Tool

What it does

lookup_business

Look up a Romanian company by name or CUI (tax code) in the official ONRC registry of 4.2M firms.

lookup_companies

Look up many Romanian companies by CUI in one call (up to 100): one result per input, in input order, each with found true/false and the company record.

find_company_by_domain

Find the Romanian firm behind a website domain (dedeman.ro).

match_companies

Match a list of up to 500 records (name, optional county, domain or CUI) to Romanian firms: each row gets match {cui, companyName, confidence, matchedOn} and the record, or no_match with up to 3 candidates.

lookup_by_category

Find companies by what they do, not by name: a curated topic ('software', 'retail'), plain words ('dentists', a CAEN class title; see matched) or CAEN codes ('4321,4322'; 6201 also finds Rev.3 6210).

lookup_director

Find Romanian companies by the name of a director or legal representative (ONRC).

extract_contacts

Crawl a company website and extract emails, phone numbers and social profiles.

enrich_company

A whole-firm profile in one call: the ONRC registry record plus the contacts discovered on that firm's website, each labelled with a confidence and a source.

lookup_domain

WHOIS plus DNS records (A, MX, NS, TXT) and an SPF/DMARC email-security audit for a domain.

lookup_financials

Annual financial statements for a Romanian company from Ministry of Finance filings, every fiscal year on record since 2008: revenue, profit, headcount and balance-sheet lines in RON with each year's ratios (growth, margins, equity ratio, liquidity), plus a summary (3/5/10-year CAGR, loss years, health score).

lookup_financial_ratios

Derived financial intelligence for a Romanian company: multi-year revenue trend (YoY, 3/5/10-year CAGR), margins, headcount, solvency and liquidity ratios, a 0-100 health score with its rule-by-rule breakdown, red flags, and peer percentiles within the same CAEN activity and county.

watch_company

Register a company (by CUI) to monitor.

watch_caen

Watch a CAEN activity code, optionally scoped to one county, for newly registered firms.

poll_watchlist

Collect everything the watch tools have found: call it to drain the changeset for every watch owned by your API key, most severe first.

unwatch

Stop watching a firm (cui) or a CAEN code (code, with its county if it had one). A watch you do not hold answers removed: 0.

get_usage

Show your own allowance: plan, daily limit, lookups used today, how many remain, when it resets (midnight Romanian time, 00:00 Europe/Bucharest) and any credit balance.

report_issue

Tell the Leadgen founder what is missing or wrong: a missing field, firm or source (kind 'gap'), a wrong company record ('wrong_record', pass its cui), a bug, an idea.

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-api.adrianhomelab.com/start. Documentație: https://leadgen-api.adrianhomelab.com/docs.

Contact

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

Available Tools

17 tools
enrich_companyCompany profile with website contactsA
Read-onlyIdempotent
Inspect

A whole-firm profile in one call: the ONRC registry record plus the contacts discovered on that firm's website, each labelled with a confidence and a source. Prefer this over lookup_business followed by extract_contacts when you want everything about one company. cui is its tax code; website overrides the registered one; max_pages bounds the crawl; refresh=true crawls now instead of answering from the cache.

Inputs: cui (required), refresh, website, max_pages. Returns: The firm's registry record plus the contacts found on its website.

extract_contactsExtract contacts from a websiteA
Read-onlyIdempotent
Inspect

Crawl a company website and extract emails, phone numbers and social profiles. Accepts a bare domain or a full URL; max_pages (1-20, default 5) bounds the crawl.

Inputs: website (required), max_pages. Returns: Contacts found on a website.

find_company_by_domainFind the company behind a websiteA
Read-onlyIdempotent
Inspect

Find the Romanian firm behind a website domain (dedeman.ro). Uses the registry's website field, else reads the site's home and legal/contact pages for the CUI or registration number it shows (matchedOn: registry_website, site_cui). Without one, it says so and offers name candidates from the page title or the domain name, each with a confidence (at most 0.7, never a match). One lookup.

Inputs: domain (required), fields, compact. Returns: The firm behind a website domain, or why none was found.

get_usageShow my daily allowanceA
Read-onlyIdempotent
Inspect

Show your own allowance: plan, daily limit, lookups used today, how many remain, when it resets (midnight Romanian time, 00:00 Europe/Bucharest) and any credit balance. Free and never counted as a lookup. Limits: 30 anonymous MCP calls a day, 50 with a free API key from https://leadgen.adrianhomelab.com/start (an email address, no payment).

Inputs: no named parameters. Returns: Your plan, daily allowance and what is left today.

lookup_businessLook up a Romanian companyA
Read-onlyIdempotent
Inspect

Look up a Romanian company by name or CUI (tax code) in the official ONRC registry of 4.2M firms. Diacritic-insensitive ('paval' finds 'PAVAL'); a CUI matches exactly. The first call for a named Romanian company. Ranked with a score: live firms first (exact name, then words), closed ones after; county lifts. For 'firms that do X in Y', use lookup_by_category (an empty result may carry a hint naming it).

Inputs: query (required), county, fields, compact, +1 more. Returns: Ranked companies for a name, or the firm with that CUI.

lookup_by_categoryFind companies by activityA
Read-onlyIdempotent
Inspect

Find companies by what they do, not by name: a curated topic ('software', 'retail'), plain words ('dentists', a CAEN class title; see matched) or CAEN codes ('4321,4322'; 6201 also finds Rev.3 6210). Narrow by county; qualify by revenue, headcount, VAT, main activity. active_only (default) drops dead and ANAF-inactive firms.

Inputs: topic (required), sort, county, fields, +11 more. Returns: A lead list: firms in an activity, newest registration first (or by turnover /…

lookup_companiesLook up many companies by CUIA
Read-onlyIdempotent
Inspect

Look up many Romanian companies by CUI in one call (up to 100): one result per input, in input order, each with found true/false and the company record. Each row is one lookup; rows past today's allowance come back not_processed (partial: true, remaining: rows to resend after the reset). fields or compact trims each record.

Inputs: cuis (required), fields, compact. Returns: One result per input CUI, in input order.

lookup_directorFind companies by directorA
Read-onlyIdempotent
Inspect

Find Romanian companies by the name of a director or legal representative (ONRC). Diacritic-insensitive. Whole words: 'pop maria' finds POP MARIA, not POPA MARIANA; prefix=true matches prefixes. The registry has no personal ID, so one name can be several people: homonyms and byCounty say so. Use this when you know a person rather than a firm.

Inputs: name (required), fields, prefix, compact, +1 more. Returns: Firms where a person with this name is director or representative.

lookup_domainDomain WHOIS, DNS and email auditA
Read-onlyIdempotent
Inspect

WHOIS plus DNS records (A, MX, NS, TXT) and an SPF/DMARC email-security audit for a domain. Use it to profile a company's web estate or check its email posture. include_dns and include_security toggle the two halves.

Inputs: domain (required), include_dns, include_security. Returns: WHOIS, DNS records and the SPF/DMARC audit of a domain.

lookup_financial_ratiosFinancial ratios and health scoreA
Read-onlyIdempotent
Inspect

Financial analysis of a Romanian company: multi-year revenue trend (YoY, 3/5/10-year CAGR), margins, headcount, solvency and liquidity ratios, a 0–100 health score with its rule-by-rule breakdown, red flags, and peer percentiles within the same CAEN activity and county. Verdict: 'growing', 'stable' or 'distressed'. Use lookup_financials for the raw figures.

Inputs: cui (required). Returns: Financial ratios, a health score, peer percentiles and a verdict.

lookup_financialsAnnual financial statementsA
Read-onlyIdempotent
Inspect

Annual financial statements for a Romanian company from Ministry of Finance filings, every fiscal year on record since 2008: revenue, profit, headcount and balance-sheet lines in RON with each year's ratios (growth, margins, equity ratio, liquidity), plus a summary (3/5/10-year CAGR, loss years, health score). Resolve the firm with lookup_business first if you only have a name.

Inputs: cui (required). Returns: Every annual filing on record for the firm, newest first (RON).

match_companiesMatch a list of records to firmsA
Read-onlyIdempotent
Inspect

Match a list of up to 500 records (name, optional county, domain or CUI) to Romanian firms: each row gets match {cui, companyName, confidence, matchedOn} and the record, or no_match with up to 3 candidates. A valid CUI wins (confidence 1.0). Each row is one lookup; rows past today's allowance come back not_processed (partial: true, remaining: rows to resend after the reset).

Inputs: rows (required), fields, compact. Returns: One match per input record, in input order.

poll_watchlistCollect watchlist changesAInspect

Collect everything the watch tools have found: call it to drain the changeset for every watch owned by your API key, most severe first. Company watches return an 'updated' entry with the changed fields and risk; CAEN and county watches return the 'new' firms registered since the last poll (200 a poll, the rest next).

Inputs: no named parameters. Returns: What changed for your watches since the last poll, most severe first.

report_issueReport missing or wrong dataAInspect

Report to the person who runs Leadgen what is missing or wrong: a missing field, firm or source (kind 'gap'), a wrong company record ('wrong_record', pass its cui), a bug, an idea. Free, never counted as a lookup. contact is optional (an address for a reply); nothing is mailed to it automatically. Registry records are corrected at the source (ONRC) and arrive with the next snapshot.

Inputs: message (required), cui, kind, contact. Returns: The receipt for the report.

unwatchStop watching a company or activityA
DestructiveIdempotent
Inspect

Stop watching a company (cui) or a CAEN activity code (code, plus the county it was watched in, if any), on your API key: the watch and its baseline are removed. Unwatching something you do not watch changes nothing (removed: 0). poll_watchlist lists your active watches.

Inputs: cui, code, county. Returns: The watch removed (or not held), and the watches you still hold.

watch_caenWatch an activity for new firmsA
Idempotent
Inspect

Watch a CAEN activity code, optionally scoped to one county, for newly registered firms. A registration-date cutoff is the baseline: only firms registered after it are reported, and poll_watchlist slides the cutoff forward so each new firm surfaces once. A retired CAEN Rev.2 code (6201) also watches its Rev.3 successor (6210), with a warning.

Inputs: code (required), county. Returns: The watch registered (or already held) for the activity code.

watch_companyWatch a company for changesA
Idempotent
Inspect

Register a company (by CUI) to monitor. Stores a fingerprint of its current registry record as the baseline; poll_watchlist then reports changes between monthly ONRC snapshots - a new director, a new CAEN activity, an address or status change - and when ANAF declares it fiscally inactive or its VAT status flips.

Inputs: cui (required). Returns: The watch registered (or already held) for the firm.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 17 tools

    Disambiguation4/5

    Seven tools share the lookup_/find_ prefix and target Romanian companies, which looks risky at a glance, but each description pins down a distinct input shape (name/CUI, batch CUIs, domain, category, director, records-to-match) and several explicitly redirect (lookup_by_category hint, 'prefer enrich_company over lookup_business + extract_contacts', 'use lookup_financials for raw figures'). The only residual fuzziness is lookup_financials vs lookup_financial_ratios and lookup_business vs lookup_companies, both mitigated by explicit guidance in the text.

    Naming Consistency4/5

    Nearly everything is snake_case verb_noun (lookup_business, match_companies, extract_contacts, watch_company, poll_watchlist), which is predictable. Minor deviations: bare 'unwatch' has no object, 'find_company_by_domain' uses find instead of the dominant lookup, and 'lookup_by_category' omits the noun.

    Tool Count4/5

    17 tools is slightly above the comfortable range but each maps to a real step in a lead-gen workflow (find, enrich, analyze, watch, account). No tool looks redundant filler; the watch/unwatch/poll trio is a legitimate lifecycle rather than padding.

    Completeness4/5

    The surface covers discovery by name, CUI, domain, category and director, bulk matching, contact extraction, enrichment, financials and ratios, plus domain/email posture and a change-watch pipeline with usage and feedback tools — strong lifecycle coverage for the domain. Gaps are modest: no bulk export of results, no saved-search/list management, and no way to inspect or cancel individual watches other than unwatch/poll.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers