entyrix-mcp
This server provides LLM clients with tools to search, look up, and analyze companies across 16+ European jurisdictions (SK, CZ, AT, EE, SI, LV, UK, and more) via the Entyrix API (requires an API key). Core capabilities:
Search & Discovery:
search_companies: Fuzzy name, address, or national ID (IČO) search with typo tolerance.advanced_search: Structured search using 57+ filters (country, NACE, turnover, profit, employee count, credit grade, NIS2, sanctions, tech stack, EU funds, etc.).list_rankings: Pre-computed leaderboards (top by turnover, public contracts, most-registered addresses, most-viewed).
Company Identity & Details:
lookup_company: Resolve by national registry ID (e.g., IČO, Firmenbuch) with country disambiguation.get_company_details: Full profile – financials, tech stack, SSL/CVE findings, NIS2 scope, sanctions, credit score/grade, address, legal form, status.
Relations & Network:
get_company_network: Shared-officer graph for multi-hop discovery of connected companies.get_company_relations: Directors, UBOs/beneficial owners, shareholders, related companies, M&A/succession events.
Financial & Compliance:
get_financials: Up to 20 years of annual statements (turnover, profit, EBITDA, ROA, ROE, assets, equity) in EUR.check_compliance: AML/sanctions screening, debtor lists (SocPoist/VšZP/tax), insolvency/bankruptcy/liquidation status, RPVS transparency (SK).find_suppliers: List Slovak public-sector (CRZ) contracts (value, buyer, dates, CPV).
Use Cases: KYB/KYC onboarding, AML screening, supplier due diligence, risk monitoring, and market research.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@entyrix-mcp Search for companies named 'Solar' in Czech Republic"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@entyrix/mcp
Model Context Protocol access to Entyrix — European business-registry (KYB) data across 23 live markets (FR, GB, RO, SK, UA, GR, CZ, BE, NO, IE, FI, CH, PL, AT, CY, LT, LV, EE, SI, ES, IT, NL, HR).
Use the remote server (recommended)
Entyrix runs a remote MCP server (Streamable HTTP, protocol 2025-03-26 … 2026-07-28):
https://entyrix.com/mcp/v1Add it as a remote / custom connector in Claude, ChatGPT, Cursor or VS Code. On the first tool call your client opens the Entyrix sign-in (OAuth 2.1 with PKCE) — no key in a config file. From the command line:
claude mcp add --transport http entyrix https://entyrix.com/mcp/v1Full instructions: https://entyrix.com/mcp.
Related MCP server: eu-company-mcp-server
This package: a stdio bridge
For clients that only speak stdio. Since 0.2.0 the package implements no tools itself — it forwards every JSON-RPC message to the remote server above with your API key from the environment, so it always exposes exactly the current catalogue. It has zero runtime dependencies.
ENTYRIX_API_KEY=sk_... npx -y @entyrix/mcp{
"mcpServers": {
"entyrix": {
"command": "npx",
"args": ["-y", "@entyrix/mcp"],
"env": { "ENTYRIX_API_KEY": "sk_..." }
}
}
}Get an API key by signing in at https://entyrix.com/login (a Free key comes with the account) or through the API (POST /api/v1/signup, then POST /api/v1/signup/verify). Without a key the server still starts and lists its tools; the first data tool call answers with these steps as an error result. Plans: https://entyrix.com/pricing.
Pin the version in production (e.g. @entyrix/mcp@0.2.2, not latest): a local MCP server runs with your privileges, and an unpinned npx -y installs whatever is published next.
Tools
Tool | What it does |
| Find companies by name across all markets |
| Exact registry-ID lookup, country-scoped |
| Compact Markdown brief of one company — the best single call |
| Full record including the enrichment layer |
| Financial statements by year with trend (EUR cents) |
| Companies connected through shared officers and owners |
| Officers, owners, parents, subsidiaries, M&A events |
| Paged filtering by country, NACE, size, turnover, status |
| One-call KYB/AML summary with a verdict |
| KYB screening of up to 25 companies at once |
| Public compliance snapshot (no account needed) |
| Public-sector contracts (B2G, not a supply chain) |
| Pre-computed leaderboards |
Every tool is read-only, declares an output schema and rejects unknown arguments. Natural-person data is licence-gated server-side and applies identically over MCP. Returned values come from public registers — treat them as untrusted data in your agent, never as instructions.
Configuration
Env var | Default | Description |
| (none) | Bearer API key from your Entyrix account |
|
| Override for staging |
|
| HTTP timeout per request |
Development
git clone <repo>
cd entyrix-mcp
npm install
npm run build
npm testLocal stdio sanity-check:
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.jsnpm run test:contract runs the bridge against the live server (no secret needed).
Quality gates
npm run check # format:check + lint + typecheck + test — the same four CI runsRun check, not the four by hand. On 2026-08-12 a release was cut after
lint + typecheck + test passed and CI went red on format:check — the one
step that got skipped because it was being remembered rather than scripted.
Releasing
npm run bump 0.2.2 # writes all four manifests, refuses on drift
npm run check
git commit -am "chore(release): 0.2.2"
git tag v0.2.2
git push && git push --tags # one push, then the tagThe version lives in four files and src/lib/__tests__/version.test.ts asserts
they agree; bump is what keeps that guard from firing on every release. Push
once — each push is a full CI run, and a release cut as four separate pushes
bills four of them (plus two red ones for the intermediate states).
npm publish runs from the tag via OIDC trusted publishing, so no token is
involved. npm versions are immutable: a bad publish cannot be recalled, only
superseded — which is why the tag is checked against package.json before
anything is published. The release is idempotent: a re-run skips an npm
version that already exists and waits for npm to serve it before registering
with the MCP Registry.
License
MIT — see LICENSE.
Available Tools
13 toolsadvanced_searchFilter companies (portfolio / market sizing)ARead-onlyIdempotentInspect
Structured company search for portfolio building and market sizing — NOT for finding one known company (use search_companies). Filters: country, NACE prefix, status, region, turnover range (EUR), employee range, founding date range, VAT payer, tax debt, sanctions. Results are paged (limit + offset); the response says how many matched. Only the listed arguments exist — anything else is rejected, never silently ignored.
Inputs: nace, limit, order, offset, +12 more. Returns: data, meta
check_compliancePublic compliance snapshotARead-onlyIdempotentInspect
Lightweight public compliance snapshot for one company (works without an account): sanctions screening, insolvency, debtor registers, VAT reliability. For the full KYB picture use kyb_check. A null field means WITHHELD or not measured — it does NOT mean clean.
Inputs: ico (required), country. Returns: data, meta
company_briefCompany brief (Markdown, LLM-ready)ARead-onlyIdempotentInspect
Compact, deterministic Markdown brief of one company (≤12 KB): identity, address, industry, latest financials, credit score and recommended limit, cyber score, risk flags (insolvency, tax debt, sanctions), NIS2 status and key people where licensed. The best single call for 'tell me about company X'. Accepts every registry identifier shape we carry (SK/CZ IČO, AT Firmenbuch e.g. '033209m', PL REGON, FR SIREN, …); pass country for anything that is not an 8-digit IČO. Every fact comes from the database — missing data is marked, never invented.
Inputs: ico (required), country, purpose. Returns: data, meta
find_suppliersPublic-sector contractsARead-onlyIdempotentInspect
Public procurement contracts this company is party to (SK CRZ + CZ Registr smluv), newest first, paged. HONEST SCOPE: this is business-to-government procurement, NOT a commercial supply chain — do not present it as one.
Inputs: ico (required), limit, years, offset, +1 more. Returns: data, meta
get_company_detailsFull company recordARead-onlyIdempotentInspect
Full record for one company: identity, address, legal form, status flags, NACE, and the whole enrichment layer we hold (web, tech stack, NIS2, EU funds, LEI, HU de minimis state aid granted, HU public procurement from EKR, …). Large — prefer company_brief unless you need a specific field. Natural-person fields are gated and may be withheld; a withheld field is not the same as an empty one.
Inputs: ico (required), country, purpose. Returns: data, meta
get_company_networkCompanies connected through peopleARead-onlyIdempotentInspect
Companies connected to this one through shared officers or owners (one hop). Use for group structure and beneficial-ownership tracing. Person names are gated like everywhere else.
Inputs: ico (required), country, purpose. Returns: data, meta
get_company_relationsDirect relationsARead-onlyIdempotentInspect
Direct relations of one company — statutory officers, owners, parents, subsidiaries, M&A events — without traversing the wider graph. shareholders are owners only; members of the supervisory board are in supervisoryBoard. SK M&A events: effectiveDate is the date stated by the register; when missing, derivedEffectiveDate may carry a date INFERRED from the absorbed firm's deregistration (effectiveDateSource: "derived") — present it as an estimate, never as a register fact.
Inputs: ico (required), country, purpose. Returns: data, meta
get_financialsFinancial statements by yearARead-onlyIdempotentInspect
Filed financial statements of one company, one row per fiscal year (newest first), with revenue, profit, assets, equity, liabilities and year-over-year trend. Amounts are EUR CENTS as integers (divide by 100 for euros). Use for trend and solvency questions; company_brief already carries the latest year.
Inputs: ico (required), years, country, purpose. Returns: data, meta
kyb_checkKYB / AML summaryARead-onlyIdempotentInspect
One-call Know-Your-Business summary for one company: registry status, insolvency, liquidation, sanctions screening, debarment, tax/social/health debts, VAT reliability and the overall risk verdict. Use before onboarding a customer or supplier. Coverage differs by country: checks[] gives each check as hit / clear / not_covered, and overall is INSUFFICIENT_DATA when no risk was found but the insolvency or sanctions registers do not exist for that country — that is NOT a clean result. A null field means WITHHELD or NOT MEASURED — it does NOT mean clean; say so when you report it.
Inputs: ico (required), country, purpose. Returns: data, meta
list_rankingsPublished rankingsARead-onlyIdempotentInspect
A published ranking by its slug (e.g. largest employers, top taxpayers). Call WITHOUT a key first to list the available slugs — inventing one returns an error.
Inputs: key. Returns: data, meta
lookup_companyLook up company by registry IDARead-onlyIdempotentInspect
Resolve exactly one company by its national registry identifier in a given country. Handles every identifier shape we carry (SK/CZ/EE IČO, AT Firmenbuch e.g. '187a', SI/LV registry numbers, …). Returns the core record: identity, address, legal form, status, NACE. For an LLM-ready summary prefer company_brief; for the full enrichment layer use get_company_details.
Inputs: ico (required), country, purpose. Returns: data, meta
screen_companiesScreen a list of companiesARead-onlyIdempotentInspect
Run kyb_check on up to 25 companies at once and get one compact row per company (status, insolvency, sanctions, debts, verdict, coverage). INSUFFICIENT_DATA = no findings but not covered by the core registers for that country — never report it as clean. Use for supplier lists or portfolios. Each company counts as one API request against your rate limit. Requires an authenticated account.
Inputs: companies (required). Returns: failed, results, screened
search_companiesSearch companies by nameARead-onlyIdempotentInspect
Find companies by name (or name fragment) across the pan-European dataset. Returns ranked candidates with registry identifier, country, legal form and status. Use this FIRST when you only know a name; then pass the identifier + country to lookup_company or company_brief. Do not use it to filter by industry or size — that is advanced_search.
Inputs: query (required), limit, country. Returns: data, meta
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools target clearly distinct operations, and the descriptions actively route the agent between lookalikes (search_companies vs advanced_search, company_brief vs get_company_details, kyb_check vs check_compliance vs screen_companies). The remaining overlaps are deliberate tiers of the same resource (lookup_company/company_brief/get_company_details, and the three compliance checks), which are well disambiguated by text but still require reading rather than being self-evident from the names.
The dominant convention is verb_noun (list_rankings, search_companies, lookup_company, get_financials, find_suppliers, screen_companies), which is applied consistently across most of the surface. Three names break the pattern into noun/adjective phrases (company_brief, advanced_search, kyb_check), but they remain readable and unambiguous.
Thirteen tools is a well-scoped size for a company-intelligence/KYB domain, with retrieval tiers, search modes, batch screening and procurement all earning a slot. Nothing appears redundant filler; each tool maps to a recognizable workflow step.
The lifecycle is broadly covered: discovery (search/advanced_search/rankings), single-entity retrieval at three depths, financials, ownership/relations, KYB screening (single, batch, unauthenticated) and public procurement. Gaps remain around multi-hop graph traversal (network is explicitly one hop), person/officer-centric lookup, and procurement coverage limited to SK/CZ, but these are minor and workaroundable.
Maintenance
Related MCP Connectors
CompanyLens is a remote MCP server giving AI agents instant access to official company registry data across 19 jurisdictions in Europe, the Americas, and Asia-Pacific. Eighteen read-only tools let you search companies and people, look up officers and beneficial owners, map corporate networks through shared directors, screen names against the UK disqualified directors register, find every company at a registered address, and pull filing history — all from a single connector. Visit our website: https://companylens.io
Remote MCP server to enrich company profiles with structured B2B data and confidence scores.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for Nordic company registries. Verify companies, check board members, signing authority, and financial data across Norway, Denmark, Finland, and Sweden using official public APIs. 23 tools covering search, details, roles, and batch lookups.1914Apache 2.0
- AlicenseAqualityDmaintenanceMCP server for EU company and business data. 9 tools: company search (GLEIF, 2M+ entities), LEI lookup, corporate structures (parent/subsidiaries), trade register search, EU VAT validation (VIES), GDP, unemployment, inflation, and business demography (Eurostat). All APIs free, no keys required.96MIT
- FlicenseNot gradedqualityDmaintenanceA local MCP server that exposes the UK Companies House API as tools for Claude Desktop and Cowork, enabling company search, profile retrieval, officer lookup, and document downloads.-
- FlicenseNot gradedqualityDmaintenanceMCP server exposing the full UK Companies House Public Data API, enabling natural language queries for company profiles, search, officers, filing history, charges, insolvency, and persons with significant control, as well as downloading and reading PDF documents.-