Does the server work without an API key?

Yes. It ships with a shared demo key so the first tool call answers right after npx — 30 requests a minute and 2,000 a day, shared by everyone using it without a key of their own. When the shared quota is used up, the error tells you how to get a free key.

What does my own key add?

A free key is 1,000 calls a month with no credit card, not shared with anyone else, and unlocks the paid scopes at Starter (€9.99/month) and above. Set it as PROMETIAM_API_KEY.

Which clients does it work with?

Any client that speaks MCP over stdio: Claude Desktop, Claude Code, Cursor, VS Code (via its MCP support), Continue and Cline are documented. Run the binary with PROMETIAM_API_KEY set; JSON-RPC on stdin, responses on stdout.

Can the agent change anything in my account?

Only through monitor_subscribe and monitor_stop, marked as mutating; every other tool is read-only. Keep the key in the client configuration, not in a prompt.

Does a tool call count against my quota?

Yes, one request per tool call. Batch tools (companies_lookup, sanctions_screen_batch, insolvency_check) count every item in the batch as one request.

Is this the same data as the REST API?

Yes — the server is a thin wrapper: every tool calls the same Prometiam REST endpoint documented at /risk-api/docs and described in the OpenAPI 3.0 specification at /openapi.json.

prometiam-risk-mcp — company data as MCP tools

A Model Context Protocol server that gives Claude Desktop, Claude Code, Cursor, VS Code and any other MCP client 35 typed tools over the Prometiam API — official company-registry data for Spain, France, the UK, Ireland, Poland and Norway, corporate events, insolvency notices, sanctions screening, VAT (VIES) and LEI (GLEIF) lookup, and monitoring — with the record behind every answer instead of a model's memory.

Install

npx -y prometiam-risk-mcp — works immediately on a shared demo key (30 requests a minute, 2,000 a day, shared by everyone who has not set their own key). For your own quota, get a free key (1,000 calls a month, no card) and set it as PROMETIAM_API_KEY.

Configure

Claude Desktop and Cursor read a JSON config with an mcpServers block naming the command npx, the args ["-y", "prometiam-risk-mcp"], and the env var PROMETIAM_API_KEY. Claude Code reads the same shape from a project .mcp.json, or add it with claude mcp add. VS Code (GitHub Copilot's MCP support) reads .vscode/mcp.json with a servers block in the same shape.

Tools, grouped by job

Company lookup (companies_search, company_detail, companies_lookup) · people & directors (people_search, person_detail, directors_network) · corporate events (events_search, events_timeline, event_detail) · insolvency (insolvency_search, insolvency_notices_search, insolvency_check, insolvency_record, notice_detail) · sanctions screening — beta (sanctions_screen, sanctions_screen_batch, sanctions_entity, sanctions_changes, sanctions_watch, sanctions_unwatch, sanctions_watchlist) · VAT & LEI validation (vat_validate, lei_lookup, lei_search, lei_relationships) · monitoring — ES, IE, PL (monitor_list, monitor_get, monitor_subscribe, monitor_stop) · public procurement — beta (procurement_awards, procurement_buyer, procurement_buyers, procurement_relationship) · account & coverage (coverage, account).

Scope limits

Sanctions screening is beta. PEP screening (an option on sanctions_screen) is beta and Spain only, with no relatives or close associates. Monitoring is Spain, Ireland and Poland only. Insolvency notices are corporate only, across nine markets (FR, DE, GB, AT, CH, NO, FI, US, NL); Spain's concursal proceedings are served by insolvency_search separately. Ireland and Poland are company-level (no officers yet); Norway has no corporate-event stream. Only monitor_subscribe and monitor_stop change anything — every other tool is read-only.

Frequently asked questions

Does the server work without an API key?: Yes. It ships with a shared demo key so the first tool call answers right after npx — 30 requests a minute and 2,000 a day, shared by everyone using it without a key of their own. When the shared quota is used up, the error tells you how to get a free key.
What does my own key add?: A free key is 1,000 calls a month with no credit card, not shared with anyone else, and unlocks the paid scopes at Starter (€9.99/month) and above. Set it as PROMETIAM_API_KEY.
Which clients does it work with?: Any client that speaks MCP over stdio: Claude Desktop, Claude Code, Cursor, VS Code (via its MCP support), Continue and Cline are documented. Run the binary with PROMETIAM_API_KEY set; JSON-RPC on stdin, responses on stdout.
Can the agent change anything in my account?: Only through monitor_subscribe and monitor_stop, marked as mutating; every other tool is read-only. Keep the key in the client configuration, not in a prompt.
Does a tool call count against my quota?: Yes, one request per tool call. Batch tools (companies_lookup, sanctions_screen_batch, insolvency_check) count every item in the batch as one request.
Is this the same data as the REST API?: Yes — the server is a thin wrapper: every tool calls the same Prometiam REST endpoint documented at /risk-api/docs and described in the OpenAPI 3.0 specification at /openapi.json.