Prometiam Company Data

prometiam-risk-mcp

Company data for Claude, Cursor, VS Code and any MCP client: company-register records for 33 countries, corporate events, insolvency notices, sanctions screening (beta), VAT and LEI checks and monitoring, as 36 typed tools. One command, no key, no signup. Germany comes from LEI records and the energy market register, not the Handelsregister.

Install it, no key

Pick your client, paste the block and restart it. Without a key the server runs on a shared demo key, so the first tool call answers at once. Company search, records, VAT, LEI and insolvency work on it; corporate events and sanctions screening need a plan, and the demo key is rate-limited for everyone who uses it.

Where: claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\)

No key

{
  "mcpServers": {
    "prometiam-risk": {
      "command": "npx",
      "args": ["-y", "prometiam-risk-mcp"]
    }
  }
}

With your own key

{
  "mcpServers": {
    "prometiam-risk": {
      "command": "npx",
      "args": ["-y", "prometiam-risk-mcp"],
      "env": { "PROMETIAM_API_KEY": "rk_live_..." }
    }
  }
}

Your own key comes with the 14-day free trial: 500 credits, card required, nothing charged for 14 days. An empty value or the placeholder rk_live_your_key_here is ignored and the demo key is used instead.

Hosted endpoint (no install)

The same 36 tools are served over Streamable HTTP at https://api.prometiam.com/functions/v1/mcp: no npx and no local process. Send your own key as Authorization: Bearer rk_live_... (X-API-Key works too). With no key it runs in demo mode on the shared demo key (30 requests a minute and 2,000 calls a day for everyone, the quota the npx demo shares); in demo mode some tools, such as sanctions_screen and events_search, answer upgrade_required. The endpoint holds no data and no secret: each tool call is one API request, priced in credits like the REST call (sanctions screening is beta). Your own key works only from a client that can send a request header.

Claude Code

Where: any terminal; add --scope project to write a shared.mcp.json

claude mcp add --transport http prometiam https://api.prometiam.com/functions/v1/mcp --header "Authorization: Bearer rk_live_..."

Cursor

Where:.cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project

{
  "mcpServers": {
    "prometiam": {
      "url": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:PROMETIAM_API_KEY}" }
    }
  }
}

VS Code

Where:.vscode/mcp.json (the key is servers, not mcpServers; the prompt keeps the key out of the file)

{
  "servers": {
    "prometiam": {
      "type": "http",
      "url": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:prometiam-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "prometiam-key", "description": "Prometiam API key", "password": true }
  ]
}

Windsurf

Where: mcp_config.json

{
  "mcpServers": {
    "prometiam": {
      "serverUrl": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:PROMETIAM_API_KEY}" }
    }
  }
}

claude.ai and ChatGPT connectors: not yet. They need OAuth sign-in, which the hosted endpoint does not offer yet.

Check that it works

Ask your assistant:

Search for companies named Inditex in Spain.

It calls companies_search and returns:

INDUSTRIA DE DISEÑO TEXTIL, S.A, NIF A15075062, active, legal form SA, Arteixo, LEI 549300TTCXZOGZM2EY83.

A 401 on the first call means an older prometiam-risk-mcp that sent the placeholder key as a real one. Update it, or remove the env block.

Last checked in Claude Desktop, Claude Code, Cursor and VS Code: To confirm

Ask it

Prompts that work, the tool each one calls and what came back. Recorded answers were taken on the demo key on 24 Oct 2026, from the endpoint the tool wraps; the MCP server returns the same JSON.

• “Is VAT number ESA15075062 valid, and which company is it?” Calls vat_validate, company_by_identifier VIES says the number is valid. The register match is INDUSTRIA DE DISEÑO TEXTIL, S.A (BORME), the same company as above. Recorded answer
• “Look up the LEI 549300TTCXZOGZM2EY83.” Calls lei_lookup INDUSTRIA DE DISEÑO TEXTIL, S.A., jurisdiction ES, entity status ACTIVE, registered at Avenida de la Diputación, Arteixo. Recorded answer
• “What happened at this company in the last year?” Calls events_timeline The demo key answers 403 upgrade_required: corporate events are not in the free plan, Starter (EUR 9.99/month) includes them. Refused on the demo key
• “Screen the name Juan Perez against the sanctions lists at threshold 85.” Calls sanctions_screen The demo key answers 403 upgrade_required: sanctions screening (beta) is not in the free plan, Professional (EUR 29.99/month) includes it. A match score is a prompt to review, not a determination. Refused on the demo key
• “Check these five counterparties for corporate insolvency notices in France and Germany.” Calls insolvency_check One call, 2 credits per name, a status per name. Corporate notices only, fifteen markets. Not recorded here

Tools, credits and plan

A successful call costs credits and an error costs nothing. Plan is the lowest plan that runs the tool; Free is the demo key and the 14-day trial. Batch tools charge every item.

Company lookup

Tool	What it does	Credits	Plan
companies_search	Search by name or identifier: NIF, SIREN/SIRET, company number, organisation number and the other national ids.	1	Free
company_detail	Full profile by Prometiam id, or by country and the register number: registry coordinates, capital, status, officers where the register has them.	1	Free
company_by_identifier	One company from a VAT number (the prefix names the country), an LEI or a company number, with no country to work out. The shortest way from an identifier to a record.	1	Free
companies_lookup	Resolve up to 100 companies in one call, by identifier or fuzzy name. Every item is charged.	1 per item	Free
company_financials	Annual accounts as filed, in the filing currency and in euro. Scale plan; other plans 10 calls a month. Where it exists is in the scope limits below.	25	Scale

People and directors

Tool	What it does	Credits	Plan
people_search	Search officers and directors by name.	2	Starter
person_detail	One person’s appointment history across companies.	2	Starter
directors_network	People appointed to many companies (nominee and hub detection, Spain).	2	Free

Corporate events

Tool	What it does	Credits	Plan
events_search	Search events: capital changes, director changes, dissolutions, mergers; without a company, the country event feed.	2	Starter
events_timeline	Chronological event history for one company.	2	Starter
event_detail	One event with before and after values and the source notice.	2	Starter

Insolvency

Tool	What it does	Credits	Plan
insolvency_search	Search insolvency and risk notices by company name or identifier.	2	Free
insolvency_notices_search	Corporate insolvency notices from official gazettes and registers in fifteen markets.	2	Free
insolvency_check	Check up to 100 counterparties for corporate insolvency notices in one call.	2 per item	Free
insolvency_record	One insolvency notice by id, with related events.	2	Free

Sanctions screening (beta)

Tool	What it does	Credits	Plan
sanctions_screen	Fuzzy-match a name against sanctions and export-control lists, with a match score.	3	Professional
sanctions_screen_batch	Screen up to 50 names in one call.	3 per name	Professional
sanctions_entity	Full detail for one sanctions entity: aliases, programme, listing date.	1	Professional
sanctions_changes	Additions, removals and amendments on the lists, newest first.	1	Starter
sanctions_watch changes your account	Add a name to your watchlist, re-screened on every list update. Changes your account.	0	Starter
sanctions_unwatch changes your account	Remove a watchlist entry by id. Changes your account.	0	Starter
sanctions_watchlist	Your watchlist and any recent hits.	0	Starter

VAT and LEI

Tool	What it does	Credits	Plan
vat_validate	Validate an EU VAT number against VIES (27 member states and Northern Ireland).	1	Free
lei_lookup	Look up a Legal Entity Identifier in the GLEIF register.	1	Free
lei_search	Resolve a company name to candidate LEIs.	1	Free
lei_relationships	GLEIF Level 2 ownership: direct and ultimate parents and children of an LEI.	1	Free

Monitoring

Tool	What it does	Credits	Plan
monitor_list	The companies monitored by this key.	0	Free
monitor_get	One monitored company with its alert history.	0	Free
monitor_subscribe changes your account	Subscribe a company to daily monitoring with a signed webhook. Changes your account.	0	Free
monitor_stop changes your account	Stop monitoring a company and delete the subscription. Changes your account.	0	Free

Public procurement (beta)

Tool	What it does	Credits	Plan
procurement_awards	Public-contract awards by supplier, buyer, identifier, CPV code or date.	2	Free
procurement_buyer	Risk profile of one public buyer: single-bid risk and supplier-insolvency exposure.	2	Free
procurement_buyers	List scored public buyers by either score.	2	Free
procurement_relationship	How dependent a public buyer and one of its top suppliers are on each other.	2	Free

Account and coverage

Tool	What it does	Credits	Plan
coverage	What is covered per country and how fresh it is.	0	Free
account	The key’s plan, rate limits, credits left and scopes.	0	Free

When a call fails

401 unauthorized	The key is missing, wrong or revoked. With the MCP server, leave the key out to use the demo key.
403 upgrade_required	The call needs a plan that includes it; the body names the plan and the price.
429 rate_limit_exceeded	Per-minute or daily limit; wait the Retry-After seconds. The shared demo key is limited for everyone who uses it.

MCP server or REST API

	MCP server	REST API
Who makes the call	The AI client picks the tool and its parameters during a conversation.	Your code, with the parameters you set.
Credentials	Optional PROMETIAM_API_KEY in the client config.	An Authorization: Bearer header on every request.
Data and credits	The same endpoints, the same JSON and the same credits per call.	The same.
Best for	Research and due diligence in a chat, prototypes, agents that decide what to look up.	Onboarding flows, batch jobs, monitoring webhooks, anything that must run the same way every time.

The REST reference is at API documentation.

Scope limits

• Sanctions screening is beta. PEP screening (an option on sanctions_screen) is beta and Spain only, with no relatives or close associates.
• Insolvency notices are corporate only, in fifteen markets: FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV and EE. Contains CVR data (Erhvervsstyrelsen), CC BY 4.0.
• Monitoring covers every live country except France: status change, dissolution, sanctions match and corporate events. Only monitor_subscribe, monitor_stop, sanctions_watch and sanctions_unwatch change anything in your account; every other tool is read-only.
• Officers come from Spain, France, the United Kingdom and Norway; Poland’s are on the company record with natural persons masked by the register. Every other country is company records only: no officers and no registry-compliance signal. Sole traders and other natural persons are not served in most registers; the country guides and /data list each register’s exclusions.
• Corporate events are gazette notices for Spain, France and the United Kingdom (Switzerland also from the Swiss Official Gazette of Commerce) and register-change events for the other live countries, dated when the change first appears in the register data. Ireland, Poland and Norway: register-change events only, none before 14 Oct 2026.
• Germany is LEI-registered entities and companies listed in the energy market register, not an extract of the Handelsregister. The United States is company records only: nine state registers plus SEC filers and LEI holders, not every US company.
• Financial statements (company_financials) are annual accounts as filed in GB, FR, DK, SE, NO, LV, FI (digitally filed), EE, RO and LT (headline figures), CO and US (SEC filers), plus listed companies in ES, PL, HR, BE and BR; Scale plan and above, 10 calls a month on lower plans. Countries and what each includes
• Spain (ES): default when no country is passed
• France (FR)
• United Kingdom (GB)
• Ireland (IE): company records only, no officers
• Poland (PL): company records only, no officers
• Norway (NO): register-change events only
• Finland (FI): company records only, no officers
• Sweden (SE): company records only; sole traders are not served
• Belgium (BE): company records only; not an insolvency market
• Croatia (HR): company records only; sole traders are not served
• Denmark (DK): company records only; no share capital
• Estonia (EE): company records only; sole traders are not served; no insolvency notices
• Slovakia (SK): company records only; commercial legal persons only; no VAT number or insolvency notices
• Switzerland (CH): company records only; legal entities and branches only, no sole proprietorships; no activity code
• Latvia (LV): company records only; individual merchants are not served; no activity code or insolvency notices
• Cyprus (CY): company records only; companies and overseas companies only, no trade names or partnerships; no activity code, VAT number or insolvency notices
• Romania (RO): company records only; natural persons and sole traders are not served; no share capital or insolvency notices
• United States (US): company records only; nine state registers plus SEC filers and LEI holders, not every US company; no VAT number
• Lithuania (LT): company records only; legal entities (JAR) only, no sole proprietorships; no insolvency notices
• Canada (CA): company records only; federal corporations only; no VAT number or insolvency notices
• Australia (AU): company records only; companies (ACN, ARBN) only; no insolvency notices
• Japan (JP): company records only; companies and registered foreign companies only; no founding date, VAT number or insolvency notices
• Israel (IL): company records only; companies only; no VAT number or insolvency notices
• Singapore (SG): company records only; companies, LLPs and foreign branches only; no VAT number or insolvency notices
• Colombia (CO): company records only; commercial register companies only; no address, VAT number or insolvency notices
• Taiwan (TW): company records only; companies and foreign branches only; no insolvency notices
• Brazil (BR): company records only; commercial legal persons only, no sole proprietors; no VAT number or insolvency notices
• Argentina (AR): company records with register-change events and monitoring since 28 Oct 2026 (the register is read monthly, none before; no dissolution alert); commercial companies only, no sociedades de hecho; no VAT number or insolvency notices
• Ukraine (UA): company records only; commercial legal persons only, ended ones included, no individual entrepreneurs; no address, activity code, contacts, officers, VAT number or insolvency notices; register-change events and monitoring
• Serbia (RS): company records only; companies only (d.o.o., a.d., o.d., k.d.), no entrepreneurs; the municipality instead of a street address; no officers, share capital, VAT number or insolvency notices; register-change events and monitoring
• Ecuador (EC): company records only; companies of the Superintendencia de Compañías list only (no associations, consortia or natural persons); the canton instead of a street address; no officers, share capital, VAT number or insolvency notices; register-change events and monitoring
• Czech Republic (CZ): company records only; commercial legal persons only; no VAT number or insolvency notices
• Germany (DE): LEI-registered entities and energy-market-register companies, not the Handelsregister; no VAT number

FAQ

Does the server work without an API key?
Yes. It ships with a shared demo key, so the first tool call answers right after npx. The key is rate-limited for everyone who uses it; when the shared quota is used up, the error tells you how to get a free key.

What does my own key add?
A key of your own is not shared with anyone, and unlocks the paid scopes: people and corporate events from Starter (EUR 9.99/month), sanctions screening from Professional (EUR 29.99/month), financial statements from Scale (EUR 99.99/month). The 14-day free trial gives 500 credits, a card is required and nothing is charged for 14 days.

Which clients does it work with?
Any client that speaks MCP over stdio. Claude Desktop, Claude Code, Cursor and VS Code are configured above; Continue and Cline work the same way.

Can the agent change anything in my account?
Only through monitor_subscribe, monitor_stop, sanctions_watch and sanctions_unwatch, marked as changing your account; every other tool is read-only. Keep the key in the client configuration, never in a prompt.

Does a tool call count against my quota?
Yes. A successful tool call costs credits: 1 for a company search or record, 2 for people, events or insolvency, 3 for each name screened, 25 for one company’s financial statements; errors cost nothing. Batch tools charge every item in the batch.

Is this the same data as the REST API?
Yes. Every tool calls the same endpoint documented in the API documentation and described in the OpenAPI specification.

Why does my client show a 401?
A prometiam-risk-mcp older than 0.4.45 reads the placeholder rk_live_your_key_here as a real key. Update it, or remove the env block to use the demo key.