Skip to main content
Glama
matiasmaquieira96

Prometiam Company Data

prometiam-risk-mcp

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.

npm version License: MIT OpenAPI

What you get

28 MCP tools that wrap the Prometiam Risk API:

Tool

Description

companies_search

Search EU + UK companies by name, NIF (ES), SIREN/SIRET (FR), company_number (UK), or organisation number (NO).

company_detail

Full company profile by Prometiam ID — officers, registry coordinates, capital, status. include=risk_flags attaches published tax-debt / debarment signals (ES).

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 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).

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).

lei_relationships

GLEIF Level-2 ownership: direct and ultimate parents/children of an LEI.

insolvency_search

Search insolvency / risk notices (bankruptcies, liquidations, judgments).

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.

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). ES, IE and PL only. Mutating.

monitor_stop

Stop monitoring a company and delete the subscription. Mutating.

prospect_companies_search

Search companies by firmographics — sector group, NACE code, company age, employee band — for ICP / prospect-list building.

prospect_people_search

Find contactable decision-makers (officers ES/FR, PSC owners GB) by seniority, department, and contact-route availability. Compliance-safe.

prospect_company_contacts

Compliance-safe contact routes (role/company emails, phone, website, LinkedIn) published by the organisation. Suppression-filtered.

prospect_suppress

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

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 28 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 28 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 (create/delete a monitoring subscription tied to your key) and prospect_suppress (adds a GDPR opt-out); 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.

License

MIT © Prometiam

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Provides access to European company data and financial filings from multiple sources including GLEIF (1.6M+ EU companies), ESEF XBRL filings (FR, DK, GB, LT, UA), UK Companies House (5M+ companies), and curated major index lists (DAX40, FTSE100, SIX).
    1
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Unmodified government company data from 27 registries, live. Cross-border UBO chain walker for AI agents. 60+ tools covering GB, IE, NO, FR, DE, NL, PL, BE, CH, LI, MC, IM, IS, CY, AU, NZ, CA, TW, HK, MY, FI, CZ, ES, IT, KR, US — raw upstream fields preserved, no LLM extraction.
    10
    17
    Apache 2.0
  • A
    license
    C
    quality
    D
    maintenance
    Access European company data and financial filings from multiple sources including GLEIF, ESEF, UK Companies House, and curated index lists. Supports search, filing retrieval, and XBRL data extraction.
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Company, KYB, VAT, sanctions, LEI and address data for 15 EU countries.

  • Live data from 27 official national company registries. Unmodified. For KYB and due diligence.

  • 5.5M verified entities, 10 countries, 13 tools. EU VAT, BORME, GLEIF, KYB. Free 100/mo.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/matiasmaquieira96/prometiam-risk-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server