Skip to main content
Glama
README.md
# @entyrix/mcp

[![npm](https://img.shields.io/npm/v/@entyrix/mcp)](https://www.npmjs.com/package/@entyrix/mcp)

Model Context Protocol access to [Entyrix](https://entyrix.com) — 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/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:

```bash
claude mcp add --transport http entyrix https://entyrix.com/mcp/v1
```

Full instructions: <https://entyrix.com/mcp>.

## 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**.

```bash
ENTYRIX_API_KEY=sk_... npx -y @entyrix/mcp
```

```json
{
  "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

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

Local stdio sanity-check:

```bash
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

```bash
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

```bash
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](./LICENSE).

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
ResponsivenessLimited data