prometiam-risk-mcpModel Context Protocol server for the Prometiam company data API — official company-registry data for Spain, France, the UK, Ireland, Poland and Norway, plus directors, corporate events, insolvency, VAT/LEI lookup and sanctions screening, as native MCP tools for Claude Desktop, Cursor, Continue, Cline, and any MCP-compatible client.
30 MCP tools that wrap the Prometiam Risk API:
Tool | Description |
| Search EU + UK companies by name, NIF (ES), SIREN/SIRET (FR), company_number (UK), or organisation number (NO). |
| Full company profile by Prometiam ID — officers, registry coordinates, capital, status. |
| Search normalized corporate events: capital changes, director changes, dissolutions, mergers, insolvency. |
| Chronological event history for one company (oldest first). |
| A single corporate-event record by ID, with before/after values and source notice. |
| Search officers / directors / shareholders by name across registries. |
| Officer / director profile with full appointment history across companies. |
| Cross-directorship rollup — people appointed to many companies (nominee/hub detection, ES). |
| Trigram-fuzzy match against 44,000+ active designations — five sanctions lists (EU consolidated, UN, OFAC, UK OFSI, French Registre des gels) plus 11 US export-control lists (BIS Entity List, Denied Persons, Unverified, MEU; State ITAR-Debarred, ISN; OFAC SSI, CMIC, MBS, PLC, CAPTA). Refreshed daily. |
| Full detail for one sanctions entity by ID — aliases, programme, listing date. |
| Additions, removals and amendments detected on the sanctions lists, newest first — answer "what changed" without re-screening a whole book of business. |
| Your sanctions watchlists and any recent hits against them. Read-only; requires the |
| Validate an EU VAT number against VIES (27 EU states + XI) — returns registered name/address when valid. |
| Look up a Legal Entity Identifier in the GLEIF global register — legal name, jurisdiction, status, address. |
| Resolve a company name to candidate LEIs (GLEIF full-text search). |
| GLEIF Level-2 ownership: direct and ultimate parents/children of an LEI. |
| Search insolvency / risk notices (bankruptcies, liquidations, judgments). |
| Corporate insolvency notices from official gazettes in FR, DE, GB, AT, CH, NO, FI, US — distress coverage in markets with no registry held. Corporate only; personal insolvency is never returned. |
| A single insolvency / risk notice by ID, with related events. |
| Registry gazette PDF metadata: edition, parse status, hash, raw text. |
| Dataset coverage stats per country (companies, events, freshness). |
| Calling key's plan, rate limits, remaining quota, and scopes. |
| List companies subscribed to ongoing monitoring for this key. |
| One monitored company by ID, with its alert history. |
| Subscribe a company to daily monitoring (events/status/sanctions → signed webhook). ES, IE and PL only. Mutating. |
| Stop monitoring a company and delete the subscription. Mutating. |
| Search companies by firmographics — sector group, NACE code, company age, employee band — for ICP / prospect-list building. |
| Find contactable decision-makers (officers ES/FR, PSC owners GB) by seniority, department, and contact-route availability. Compliance-safe. |
| Compliance-safe contact routes (role/company emails, phone, website, LinkedIn) published by the organisation. Suppression-filtered. |
| Add an email/domain/LinkedIn/phone/person/company to the prospecting opt-out list (GDPR). Mutating. |
Source: Spain (BORME), France (BODACC), United Kingdom (Companies House), Ireland (CRO), Poland (KRS), Norway (Brønnøysundregistrene / Enhetsregisteret, NLOD) — 26M+ companies. Daily updates. EU data residency.
Officer/director data is held for Spain, France, the UK and Norway. Ireland and Poland are company-level for now. Norway has no corporate-event stream, so the event tools return nothing for country=NO.
Related MCP server: ENTIA Entity Verification
npx -y prometiam-risk-mcp # one-shot run, no install needed
# or
npm install -g prometiam-risk-mcp # global install for the binYou need a Prometiam API key. Free tier: 1,000 calls/month, no credit card. Sign up at https://www.prometiam.com/signup.
Set it as an environment variable:
export PROMETIAM_API_KEY="rk_live_..."Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"prometiam-risk": {
"command": "npx",
"args": ["-y", "prometiam-risk-mcp"],
"env": {
"PROMETIAM_API_KEY": "rk_live_your_key_here"
}
}
}
}Restart Claude Desktop. The 30 tools appear in the tool list. Try:
"What's the Prometiam coverage today?" "Search for companies named Mercadona in Spain." "Run a sanctions screen on the name Juan Perez at threshold 85." "Build a corporate-event timeline for Inditex."
Edit .cursor/mcp.json in your project (or globally at ~/.cursor/mcp.json):
{
"mcpServers": {
"prometiam-risk": {
"command": "npx",
"args": ["-y", "prometiam-risk-mcp"],
"env": {
"PROMETIAM_API_KEY": "rk_live_your_key_here"
}
}
}
}Add to ~/.continue/config.json under experimental.modelContextProtocolServers:
{
"experimental": {
"modelContextProtocolServers": [
{
"transport": {
"type": "stdio",
"command": "npx",
"args": ["-y", "prometiam-risk-mcp"],
"env": { "PROMETIAM_API_KEY": "rk_live_your_key_here" }
}
}
]
}
}Anything that speaks MCP over stdio works. Run the binary with PROMETIAM_API_KEY set in the environment. JSON-RPC requests on stdin, responses on stdout, logs on stderr.
Variable | Required | Default |
| Yes | — |
| No |
|
Once installed and configured, you can verify the server lists tools without spinning up an MCP client:
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | PROMETIAM_API_KEY=rk_live_... npx -y prometiam-risk-mcpYou should see a JSON-RPC response with all 30 tools and their schemas.
Per Prometiam tier (returned in every response's meta.rate_limit):
Tier | Price | Calls/month | Daily cap | RPM |
Free | €0 | 1,000 | 200 | 10 |
Starter | €9.99 | 10,000 | 2,000 | 60 |
Professional | €29.99 | 100,000 | 20,000 | 300 |
Scale | €99.99 | 1,000,000 | 200,000 | 600 |
Enterprise | Custom | Custom | Custom | Custom |
All requests hit the Prometiam Risk API in EU (AWS eu-central-1, Frankfurt).
The MCP server adds no telemetry of its own — it just forwards requests to the API.
Officer data is processed under GDPR Article 6(1)(c) (legal obligation of public registries) and 6(1)(f) (legitimate interest in fraud prevention).
Mostly read-only. The only mutating tools are monitor_subscribe and monitor_stop (create/delete a monitoring subscription tied to your key) and prospect_suppress (adds a GDPR opt-out); every other tool is read-only.
This package is open source under the MIT license. The Risk API itself is a commercial service — see https://www.prometiam.com for terms.
API documentation: https://www.prometiam.com/risk-api/docs
OpenAPI 3.0 spec: https://www.prometiam.com/openapi.json
Pricing: https://www.prometiam.com/pricing
Support: https://www.prometiam.com/contact
MIT © Prometiam
This server cannot be deployed
Company, KYB, VAT, sanctions, LEI and address data for 15 EU countries.
European business data — French company check, EU VAT validation, legal search.
French & European company registry for AI agents: KYB, sanctions, annual accounts. x402, no API key.
Live data from 27 official national company registries. Unmodified. For KYB and due diligence.
