Skip to main content
Glama

@entyrix/mcp

npm

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).

Entyrix runs a remote MCP server (Streamable HTTP, protocol 2025-03-26 … 2026-07-28):

https://entyrix.com/mcp/v1

Add 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/v1

Full 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

search_companies

Find companies by name across all markets

lookup_company

Exact registry-ID lookup, country-scoped

company_brief

Compact Markdown brief of one company — the best single call

get_company_details

Full record including the enrichment layer

get_financials

Financial statements by year with trend (EUR cents)

get_company_network

Companies connected through shared officers and owners

get_company_relations

Officers, owners, parents, subsidiaries, M&A events

advanced_search

Paged filtering by country, NACE, size, turnover, status

kyb_check

One-call KYB/AML summary with a verdict

screen_companies

KYB screening of up to 25 companies at once

check_compliance

Public compliance snapshot (no account needed)

find_suppliers

Public-sector contracts (B2G, not a supply chain)

list_rankings

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

ENTYRIX_API_KEY

(none)

Bearer API key from your Entyrix account

ENTYRIX_BASE_URL

https://entyrix.com

Override for staging

ENTYRIX_TIMEOUT_MS

60000

HTTP timeout per request

Development

git clone <repo>
cd entyrix-mcp
npm install
npm run build
npm test

Local stdio sanity-check:

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

npm 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 runs

Run 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 tag

The 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 tools
check_compliancePublic compliance snapshotA
Read-onlyIdempotent
Inspect

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)A
Read-onlyIdempotent
Inspect

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 contractsA
Read-onlyIdempotent
Inspect

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 recordA
Read-onlyIdempotent
Inspect

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 peopleA
Read-onlyIdempotent
Inspect

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 relationsA
Read-onlyIdempotent
Inspect

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 yearA
Read-onlyIdempotent
Inspect

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 summaryA
Read-onlyIdempotent
Inspect

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 rankingsA
Read-onlyIdempotent
Inspect

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 IDA
Read-onlyIdempotent
Inspect

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 companiesA
Read-onlyIdempotent
Inspect

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 nameA
Read-onlyIdempotent
Inspect

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

    A4.2/5.0

    Scored across 13 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP 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.
      19
      14
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      9
      6
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP 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.
      -