prometiam-risk-mcpModel Context Protocol server for the Prometiam company data API — official company-registry data for Spain, France, the UK, Ireland, Poland, Norway, Finland, Sweden, Croatia, Belgium and Denmark, plus directors, corporate events, insolvency, VAT/LEI lookup, sanctions screening, Spanish public-procurement awards and public-buyer risk scores, as native MCP tools for Claude Desktop, Cursor, Continue, Cline, and any MCP-compatible client.
35 MCP tools that wrap the Prometiam Risk API:
Tool | Description |
| Search EU + UK companies by name, NIF (ES), SIREN/SIRET (FR), company_number (UK), organisation number (NO), Y-tunnus (FI), organisationsnummer (SE), MBS/OIB (HR), enterprise number (BE), or CVR number (DK). |
| Full company profile by Prometiam ID — officers, registry coordinates, capital, status. |
| Search normalized corporate events: capital changes, director changes, dissolutions, mergers, insolvency (ES, FR, GB from their gazettes; register-change events for FI, SE, BE, HR, DK; none for IE, PL, NO). |
| Event history for one company, newest 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 |
| Add a name to your sanctions watchlist: re-screened on every list update, with an optional webhook. Requires the |
| Remove one of your watchlist entries by id. Mutating. |
| 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, NL, DK, HR, SE — distress coverage in markets with no registry held. Corporate only; personal insolvency is never returned. |
| Resolve up to 100 companies in one call by registry number, NIF, SIREN, VAT or name (best fuzzy match with match_score). Every item counts as one request; an over-quota batch is refused up front with |
| Screen up to 50 names in one call (sanctions scope). Per-item status match / clear / error / timeout with the same hits as |
| Check up to 100 counterparties for corporate insolvency notices in one call across FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE; up to 5 notices per item plus latest_filing_date. |
| 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 (status, dissolution, sanctions and, for ES and FI/SE/BE/HR/DK, corporate events → signed webhook). ES, IE, PL, FI, SE, BE, HR and DK only. Mutating. |
| Stop monitoring a company and delete the subscription. Mutating. |
| Public-contract awards from Spain, France, the UK, Ireland, Poland and Norway by supplier, buyer, identifier, CPV code or date, one row per award to one supplier, linked to the supplier's registry record where the identifier resolves (ES, FR, GB). Ireland, Poland and Norway above the EU thresholds only. |
| Risk profile of a public buyer (the contracting body) in Spain or France — beta. Two calibrated scores: single-bid risk and supplier-insolvency exposure, each with a 1-10 score, a probability and the evidence awards. Never a supplier score. |
| List scored public buyers by either score — a portfolio screen, a region view, or a name lookup to find a buyer's id. Beta, ES + FR. |
| How dependent a public buyer and one of its five largest suppliers are on each other: awards, value, share, single-bid count, insolvency date. Beta, ES + FR. |
Source: Spain (BORME), France (BODACC), United Kingdom (Companies House), Ireland (CRO), Poland (KRS), Norway (Brønnøysundregistrene / Enhetsregisteret, NLOD), Finland (Kaupparekisteri), Sweden (Bolagsverket), Croatia (Sudski registar), Belgium (KBO/BCE), Denmark (CVR) — 26M+ companies. Daily updates for Spain, France, Ireland, Poland and Norway, monthly bulk plus daily delta for the UK, and every working day for Finland, Sweden, Belgium, Denmark and Croatia. 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 (nor for IE and PL). Finland, Sweden, Belgium, Croatia and Denmark are company records only, with register-change events (name, status, legal form and registered address; share capital for Croatia; dated when the change first appears in the register data, not gazette notices, none before 2026-09-30) and monitoring, but no officers and no registry-compliance signal. Corporate insolvency notices are linked by business ID (Finland), organisationsnummer (Sweden), MBS (Croatia) and CVR number (Denmark): Swedish notices are Bolagsverket's procedure data (konkurs, företagsrekonstruktion, ackordsförhandling), updated weekly, with no court, case number or link; Croatian notices are court decisions with court and case number where the register states them, only for companies still on the register; Danish notices come from CVR credit information (konkurs and tvangsakkord decisions), with no court or case number. Belgium has no insolvency notices (its bankruptcy shows in the company status and in its register-change events). Sole traders (enskild näringsverksamhet, trgovac pojedinac), enterprises of natural persons (eenmanszaak / entreprise individuelle), sole proprietorships (enkeltmandsvirksomhed) and estates are never served; Denmark has no share capital, and its status includes the register's bankruptcy state. Contains CVR data (Erhvervsstyrelsen), CC BY 4.0.
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 binIt works without any key. The server ships with a shared demo key — 30 requests a minute and 2,000 a day for everyone using it — so the first tool call answers right after npx. When the shared quota is used up the error tells you how to continue.
For your own quota — free 14-day trial: 1,000 calls, no credit card — sign up at https://www.prometiam.com/signup?utm_source=mcp and set the key 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 35 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 |
| No — the shared demo key is used without it | — |
| 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 29 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); 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/mcp for the install page, or 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.
Verify companies in French and UK registries, EU VAT numbers and IBANs; screen US and UN sanctions.
Live data from 80+ official national company registries. Unmodified. For KYB and due diligence.
