prometiam-risk-mcp

Model Context Protocol server for the Prometiam Risk Intelligence API — EU + UK company-registry data, sanctions screening, and corporate-event monitoring as native MCP tools for Claude Desktop, Cursor, Continue, Cline, and any MCP-compatible client.

What you get

22 MCP tools that wrap the Prometiam Risk API:

| Tool | Description | |---|---| | companies_search | Search EU + UK companies by name, NIF (ES), SIREN/SIRET (FR), or company_number (UK). | | company_detail | Full company profile by Prometiam ID — officers, registry coordinates, capital, status. | | events_search | Search normalized corporate events: capital changes, director changes, dissolutions, mergers, insolvency. | | events_timeline | Chronological event history for one company (oldest first). | | event_detail | A single corporate-event record by ID, with before/after values and source notice. | | people_search | Search officers / directors / shareholders by name across registries. | | person_detail | Officer / director profile with full appointment history across companies. | | directors_network | Cross-directorship rollup — people appointed to many companies (nominee/hub detection, ES). | | sanctions_screen | Trigram-fuzzy match against five sanctions lists: EU consolidated, UN, OFAC, UK OFSI, and the French Registre des gels. | | sanctions_entity | Full detail for one sanctions entity by ID — aliases, programme, listing date. | | vat_validate | Validate an EU VAT number against VIES (27 EU states + XI) — returns registered name/address when valid. | | lei_lookup | Look up a Legal Entity Identifier in the GLEIF global register — legal name, jurisdiction, status, address. | | lei_search | Resolve a company name to candidate LEIs (GLEIF full-text search). | | insolvency_search | Search insolvency / risk notices (bankruptcies, liquidations, judgments). | | insolvency_record | A single insolvency / risk notice by ID, with related events. | | notice_detail | Registry gazette PDF metadata: edition, parse status, hash, raw text. | | coverage | Dataset coverage stats per country (companies, events, freshness). | | account | Calling key's plan, rate limits, remaining quota, and scopes. | | monitor_list | List companies subscribed to ongoing monitoring for this key. | | monitor_get | One monitored company by ID, with its alert history. | | monitor_subscribe | Subscribe a company to daily monitoring (events/status/sanctions → signed webhook). Mutating. | | monitor_stop | Stop monitoring a company and delete the subscription. Mutating. |

Source: Spain (BORME), France (BODACC), United Kingdom (Companies House), Ireland (CRO), Poland (KRS) — 26M+ companies. Daily updates. EU data residency.

Install

npx -y prometiam-risk-mcp   # one-shot run, no install needed
# or
npm install -g prometiam-risk-mcp   # global install for the bin

Configure

You 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_..."

Use with Claude Desktop

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 22 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."

Use with Cursor

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"
      }
    }
  }
}

Use with Continue

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" }
        }
      }
    ]
  }
}

Use with any other MCP client

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.

Environment variables

| Variable | Required | Default | |---|---|---| | PROMETIAM_API_KEY | Yes | — | | PROMETIAM_BASE_URL | No | https://api.prometiam.com/functions/v1/risk-api |

Smoke test

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-mcp

You should see a JSON-RPC response with all 22 tools and their schemas.

Rate limits & pricing

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 |

Privacy and data residency

• 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, which create/delete a monitoring subscription tied to your key; every other tool is read-only.

Source

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

License

MIT © Prometiam