{
  "markdown": "# `prometiam-risk-mcp`\n\n> Model 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.\n\n[![npm version](https://img.shields.io/npm/v/prometiam-risk-mcp.svg)](https://www.npmjs.com/package/prometiam-risk-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![OpenAPI](https://img.shields.io/badge/OpenAPI-3.0-green)](https://www.prometiam.com/openapi.json)\n\n## What you get\n\n30 MCP tools that wrap the [Prometiam Risk API](https://www.prometiam.com/risk-api/docs):\n\n| Tool | Description |\n|---|---|\n| `companies_search` | Search EU + UK companies by name, NIF (ES), SIREN/SIRET (FR), company_number (UK), or organisation number (NO). |\n| `company_detail` | Full company profile by Prometiam ID — officers, registry coordinates, capital, status. `include=risk_flags` attaches published tax-debt / debarment signals (ES). |\n| `events_search` | Search normalized corporate events: capital changes, director changes, dissolutions, mergers, insolvency. |\n| `events_timeline` | Chronological event history for one company (oldest first). |\n| `event_detail` | A single corporate-event record by ID, with before/after values and source notice. |\n| `people_search` | Search officers / directors / shareholders by name across registries. |\n| `person_detail` | Officer / director profile with full appointment history across companies. |\n| `directors_network` | Cross-directorship rollup — people appointed to many companies (nominee/hub detection, ES). |\n| `sanctions_screen` | 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. `include_pep=true` adds a PEP block (beta, ES, national politicians only — no relatives or close associates). |\n| `sanctions_entity` | Full detail for one sanctions entity by ID — aliases, programme, listing date. |\n| `sanctions_changes` | Additions, removals and amendments detected on the sanctions lists, newest first — answer \"what changed\" without re-screening a whole book of business. |\n| `sanctions_watchlist` | Your sanctions watchlists and any recent hits against them. Read-only; requires the `sanctions_watch` scope. |\n| `vat_validate` | Validate an EU VAT number against VIES (27 EU states + XI) — returns registered name/address when valid. |\n| `lei_lookup` | Look up a Legal Entity Identifier in the GLEIF global register — legal name, jurisdiction, status, address. |\n| `lei_search` | Resolve a company name to candidate LEIs (GLEIF full-text search). |\n| `lei_relationships` | GLEIF Level-2 ownership: direct and ultimate parents/children of an LEI. |\n| `insolvency_search` | Search insolvency / risk notices (bankruptcies, liquidations, judgments). |\n| `insolvency_notices_search` | 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. |\n| `insolvency_record` | A single insolvency / risk notice by ID, with related events. |\n| `notice_detail` | Registry gazette PDF metadata: edition, parse status, hash, raw text. |\n| `coverage` | Dataset coverage stats per country (companies, events, freshness). |\n| `account` | Calling key's plan, rate limits, remaining quota, and scopes. |\n| `monitor_list` | List companies subscribed to ongoing monitoring for this key. |\n| `monitor_get` | One monitored company by ID, with its alert history. |\n| `monitor_subscribe` | Subscribe a company to daily monitoring (events/status/sanctions → signed webhook). ES, IE and PL only. **Mutating.** |\n| `monitor_stop` | Stop monitoring a company and delete the subscription. **Mutating.** |\n| `prospect_companies_search` | Search companies by firmographics — sector group, NACE code, company age, employee band — for ICP / prospect-list building. |\n| `prospect_people_search` | Find contactable decision-makers (officers ES/FR, PSC owners GB) by seniority, department, and contact-route availability. Compliance-safe. |\n| `prospect_company_contacts` | Compliance-safe contact routes (role/company emails, phone, website, LinkedIn) published by the organisation. Suppression-filtered. |\n| `prospect_suppress` | Add an email/domain/LinkedIn/phone/person/company to the prospecting opt-out list (GDPR). **Mutating.** |\n\nSource: 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.\n\nOfficer/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`.\n\n## Install\n\n```bash\nnpx -y prometiam-risk-mcp   # one-shot run, no install needed\n# or\nnpm install -g prometiam-risk-mcp   # global install for the bin\n```\n\n## Configure\n\nYou need a Prometiam API key. **Free tier: 1,000 calls/month, no credit card.** Sign up at <https://www.prometiam.com/signup>.\n\nSet it as an environment variable:\n\n```bash\nexport PROMETIAM_API_KEY=\"rk_live_...\"\n```\n\n## Use with Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"prometiam-risk\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"prometiam-risk-mcp\"],\n      \"env\": {\n        \"PROMETIAM_API_KEY\": \"rk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The 30 tools appear in the tool list. Try:\n\n> \"What's the Prometiam coverage today?\"\n> \"Search for companies named Mercadona in Spain.\"\n> \"Run a sanctions screen on the name Juan Perez at threshold 85.\"\n> \"Build a corporate-event timeline for Inditex.\"\n\n## Use with Cursor\n\nEdit `.cursor/mcp.json` in your project (or globally at `~/.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"prometiam-risk\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"prometiam-risk-mcp\"],\n      \"env\": {\n        \"PROMETIAM_API_KEY\": \"rk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Use with Continue\n\nAdd to `~/.continue/config.json` under `experimental.modelContextProtocolServers`:\n\n```json\n{\n  \"experimental\": {\n    \"modelContextProtocolServers\": [\n      {\n        \"transport\": {\n          \"type\": \"stdio\",\n          \"command\": \"npx\",\n          \"args\": [\"-y\", \"prometiam-risk-mcp\"],\n          \"env\": { \"PROMETIAM_API_KEY\": \"rk_live_your_key_here\" }\n        }\n      }\n    ]\n  }\n}\n```\n\n## Use with any other MCP client\n\nAnything 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.\n\n## Environment variables\n\n| Variable | Required | Default |\n|---|---|---|\n| `PROMETIAM_API_KEY` | **Yes** | — |\n| `PROMETIAM_BASE_URL` | No | `https://api.prometiam.com/functions/v1/risk-api` |\n\n## Smoke test\n\nOnce installed and configured, you can verify the server lists tools without spinning up an MCP client:\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | PROMETIAM_API_KEY=rk_live_... npx -y prometiam-risk-mcp\n```\n\nYou should see a JSON-RPC response with all 30 tools and their schemas.\n\n## Rate limits & pricing\n\nPer Prometiam tier (returned in every response's `meta.rate_limit`):\n\n| Tier | Price | Calls/month | Daily cap | RPM |\n|---|---|---|---|---|\n| Free | €0 | 1,000 | 200 | 10 |\n| Starter | €9.99 | 10,000 | 2,000 | 60 |\n| Professional | €29.99 | 100,000 | 20,000 | 300 |\n| Scale | €99.99 | 1,000,000 | 200,000 | 600 |\n| Enterprise | Custom | Custom | Custom | Custom |\n\n## Privacy and data residency\n\n- All requests hit the Prometiam Risk API in **EU** (AWS eu-central-1, Frankfurt).\n- The MCP server adds **no telemetry of its own** — it just forwards requests to the API.\n- Officer data is processed under GDPR Article 6(1)(c) (legal obligation of public registries) and 6(1)(f) (legitimate interest in fraud prevention).\n- 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.\n\n## Source\n\nThis package is open source under the MIT license. The Risk API itself is a commercial service — see <https://www.prometiam.com> for terms.\n\n- API documentation: <https://www.prometiam.com/risk-api/docs>\n- OpenAPI 3.0 spec: <https://www.prometiam.com/openapi.json>\n- Pricing: <https://www.prometiam.com/pricing>\n- Support: <https://www.prometiam.com/contact>\n\n## License\n\nMIT © Prometiam\n",
  "bytes": 9038,
  "sha": "4a3329bf0bd0c36f1de2117f2691cd4bf7885d630088e9aace75c42735409aa3",
  "repo_slug": "matiasmaquieira96/prometiam-risk-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matiasmaquieira96_risk_mcp_d6a82855/readme"
}