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, Norway, Finland, Sweden, Croatia, Belgium, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Czech Republic, Germany, the Netherlands, Brazil, Argentina, Ukraine, Serbia, Ecuador, Chile and the United States (state registers, SEC EDGAR, GLEIF), plus directors, corporate events, insolvency, VAT/LEI lookup, sanctions screening, annual financial statements, public-procurement awards (Spain, France, the UK, Ireland, Poland, Norway) and public-buyer risk scores (Spain, France), as native MCP tools for Claude Desktop, Cursor, Continue, Cline, and any MCP-compatible client.

[npm version] [License: MIT] [OpenAPI]

What you get

36 MCP tools that wrap the Prometiam Risk API:

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), Estonia (e-Business Register), Slovakia (RPO), Switzerland (Zefix), Latvia (Register of Enterprises), Cyprus (DRCOR), Romania (ONRC), Lithuania (JAR), Canada (Corporations Canada), Australia (ASIC and the ABR), Japan (National Tax Agency), Israel (Corporations Authority), Argentina (Registro Nacional de Sociedades), Brazil (CNPJ), Colombia (RUES), Singapore (ACRA), Taiwan (GCIS), the Czech Republic (public register of the Ministry of Justice, and RES), Germany (LEI-registered entities and energy-market register companies), Ukraine (EDR, Ministry of Justice), Serbia (Business Registers Agency, APR), Ecuador (Superintendencia de Compañías, SCVS, and the Servicio de Rentas Internas, SRI), Chile (Registro de Empresas y Sociedades (RES), Ministerio de Economía, Fomento y Turismo; the companies of the simplified regime of Ley 20.659), and in the United States the New York, Colorado, Connecticut, Pennsylvania, Florida, Iowa, the District of Columbia and Texas state registers, SEC EDGAR and GLEIF — 33M+ companies. Daily updates for Spain, France, Ireland, Poland and Norway, monthly bulk plus daily delta for the UK, every working day for Finland, Belgium, Denmark, Croatia, Estonia, Slovakia, Switzerland, Latvia, Lithuania, Canada, Japan, Israel, Taiwan and the Czech Republic, weekly for Sweden, Australia and the United States, and monthly for Cyprus, Romania, Singapore, Colombia, Brazil and Argentina. EU data residency.

Every company carries its age (age_years, age_band, age_basis: whole years on the day of the answer since the founding date, else the registration date; none for Switzerland and Japan, whose registers publish no founding date, and none for Germany, which serves no founding date; in an LEI layer the date is the entity creation date GLEIF holds, which can be later than the start of the company) and its industry in several vocabularies: the NACE class with its English title (nace_title), the same activity as a NACE Rev. 2 and a NACE Rev. 2.1 class or division, the ISIC Rev. 4 class and the US NAICS 2022 sector and subsector, through the official correspondence tables of Eurostat, the United Nations and the US Census Bureau: a class only where the table links exactly one, the division where the linked classes share one, otherwise null.

Officer/director data is held for Spain, France, the UK, Norway and Poland (Polish natural persons are masked by the register itself). Ireland is company-level for now. Ireland, Poland and Norway have register-change events only, from 14 Oct 2026 (no gazette). Finland, Sweden, Belgium, Croatia, Denmark, Estonia, Slovakia, Switzerland, Latvia, Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Czech Republic, Germany, the Netherlands, Ukraine, Serbia, Ecuador, Brazil and the United States are company records only, with register-change events (name, status, legal form and registered address; share capital for Croatia; for Ukraine name, status, legal form and share capital, no registered address; for Serbia name, status, legal form and the municipality as the address; for Ecuador name, status, legal form and the canton as the address, no share capital; dated when the change first appears in the register data (for the United States, the weekly read of the registers that first sees it), 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), CVR number (Denmark) and UID (Switzerland, where the SHAB notice names the debtor's UID): 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): one notice per proceeding, dated by the decision that opened it, with the latest stage of the proceeding, with no court or case number. Spanish notices are the concurso entries (declaration, opening of the liquidation phase, conclusion) published in BORME since 2009, one per court resolution, linked by NIF and dated by the court's resolution date with the BORME publication date alongside (a median of about ten weeks later, sometimes more than a year); legal entities with a NIF only, judge and administrator never served, and an entry that cannot be tied to the company, or whose NIF is an administrator's, is withheld. Latvian notices are the Insolvency Register's insolvency and legal protection proceedings, an opening notice and a closing notice each, since 2008, with court and case number where stated, linked by registration number, legal persons of the commercial register only, updated daily. Estonian notices are bankruptcy declarations from the e-Business Register, one per register entry, dated by the entry (a few days after the court's order), linked by registry code, with no court, case number, trustee or closing notice, for companies still on the register, in liquidation or in bankruptcy only (a floor), sole traders (FIE) never served. Belgium and Slovakia have no insolvency notices (their bankruptcy shows in the company status and in their 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. Switzerland, Latvia and Cyprus have no activity code (Cyprus, Romania, Lithuania, Canada, Australia, Japan, Israel, Singapore, Colombia, Taiwan, Czech Republic and Brazil have no insolvency notices; Latvian individual merchants, Cypriot trade names and partnerships and Romanian natural persons and sole traders are never served; Cyprus has no VAT number; Romania has no share capital and its VAT number is built from the CUI by rule), and its sole proprietorships and other natural persons are never served. Every company object carries vat_number and vat_number_source (published by the register, or built from the identifier by rule where the registration is not confirmed; null for the UK, Ireland, Slovakia, Cyprus, the United States, Canada, Japan, Israel, Brazil, Colombia and Singapore). United States (country=US): company records from the business registers of New York, Colorado, Connecticut, Pennsylvania, Florida, Iowa, the District of Columbia and Texas (state open data and public records) plus SEC filers (EDGAR) and LEI holders (GLEIF) from every state, Delaware included, as one record per state registration (NY-4424185, CIK-0000320193, LEI-…); New York, Pennsylvania and Iowa active entities only; updated weekly; no officers and no registry-compliance signal, with register-change events (dated by the weekly read) and monitoring; no VAT number; US insolvency notices are not linked to the company records; sole proprietorships never served; not every US company. US sources: New York Department of State, Colorado Secretary of State, Connecticut Secretary of the State, Pennsylvania Department of State (open data), Florida Department of State, Division of Corporations (public records), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), SEC EDGAR, GLEIF (CC0). Contains CVR data (Erhvervsstyrelsen), CC BY 4.0. Source: Zefix, Federal Office of Justice, Federal Commercial Registry Office (open use, source required); restructured by Prometiam, not a certified register extract. Contains data from the Register of Enterprises of the Republic of Latvia and the State Revenue Service (CC0). Contains data from the Department of the Registrar of Companies and Intellectual Property (DRCOR), Republic of Cyprus, via data.gov.cy, CC BY 4.0. Contains data from the National Trade Register Office (ONRC), CC BY 4.0. Lithuania: Company records from the Register of Legal Entities (JAR): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Company status includes liquidation, bankruptcy and restructuring; there are no insolvency notices. Activity codes follow NACE Rev. 2.1 (EVRK 2.1, class level; the 6-digit code is in registry_details). Share capital is held for UAB and AB only. VAT numbers come from the State Tax Inspectorate (VMI) list. Sole proprietorships, partnerships (KUB, TUB), branches, state enterprises and non-commercial bodies are never served. Credit: Contains data from the Register of Legal Entities (JAR), Registrų centras, the State Data Agency (Statistics Lithuania) and the State Tax Inspectorate (VMI), CC BY 4.0. Adapted by Prometiam. Canada: Company records from Corporations Canada (Innovation, Science and Economic Development Canada): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Federal corporations only (Canada Business Corporations Act, Canada Cooperatives Act and the repealed Canada Corporations Act Part I and Cooperative Associations Act); provincial and territorial corporations, not-for-profit corporations and boards of trade are not in the register. There is no insolvency, liquidation or bankruptcy status (that is the Office of the Superintendent of Bankruptcy and the courts), no activity code, share capital or VAT number. The Business Number is searchable with business_number=, and a corporation's other names are in registry_details. Credit: Contains information licensed under the Open Government Licence – Canada (Corporations Canada, Innovation, Science and Economic Development Canada). Adapted by Prometiam. Australia: Company records from the Australian Securities and Investments Commission (ASIC) and the Australian Business Register (ABR): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated weekly. Proprietary, public and foreign companies (ACN and ARBN) only; associations, cooperatives, other bodies, individuals and sole traders are never served. The register gives the state and the postcode, not a street address. ASIC does not separate liquidation from administration, so external administration shows as in_administration and there is no in_liquidation status; there are no insolvency notices. No activity code or share capital. The VAT number is the ABN when the ABN is active and registered for GST; an ABN is searchable with abn= and a GST-registered one with vat=. Data are licensed CC BY 3.0 AU (no sublicensing): the credit and licence link travel with every answer. Credit: Contains data from the Australian Securities and Investments Commission (ASIC) Company Dataset and the Australian Business Register (ABN Bulk Extract), licensed CC BY 3.0 AU (https://creativecommons.org/licenses/by/3.0/au/). Adapted by Prometiam (joined, normalised, status derived). Japan: Company records from the National Tax Agency corporate number publication site: legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day, with a monthly full reconciliation. Companies (kabushiki, godo, gomei, goshi and tokurei yugen kaisha) and registered foreign companies only; national and local government bodies, associations and other corporations are never served. Status is active, deregistered or merged (with the successor's number): the register publishes no liquidation or insolvency state and there are no insolvency notices; no founding date, activity code, share capital or VAT number. The registration date is the date the corporate number was assigned and is null for companies that carry only the 5 October 2015 designation. Names are in Japanese; the English name, the kana reading and a romanised name are in registry_details. A search in Latin letters also meets the romanised name and, for about 3,600 companies (mostly large and listed), the English names GLEIF holds (CC0; search aliases only, name_en stays the National Tax Agency name). Credit: Source: National Tax Agency Corporate Number Publication Site (https://www.houjin-bangou.nta.go.jp/). Edited and processed by Prometiam; not a product of the National Tax Agency or the State. 出典：国税庁法人番号公表サイト（https://www.houjin-bangou.nta.go.jp/）。Prometiamが編集・加工して作成（国税庁が作成した情報ではありません）。 Israel: Company records from the Israeli Corporations Authority (Ministry of Justice): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Israeli and registered foreign companies only; partnerships, cooperative societies, non-profit associations and sole traders are other registers and are not served. Company status includes liquidation, receivership, restructuring and insolvency proceedings; there are no insolvency notices. Names are in Hebrew, with the English name in registry_details where the register holds one. A search in Latin letters also meets, for about 2,000 more companies, the English names GLEIF holds (CC0; search aliases only). No activity code, share capital or VAT number. Credit: Contains information from the Israeli Corporations Authority, Ministry of Justice, via data.gov.il (used under the data.gov.il terms of use). Adapted by Prometiam; not an official register extract. Brazil: Company records from the Cadastro Nacional da Pessoa Jurídica (CNPJ), Receita Federal do Brasil: legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly (the Receita publishes one full file a month). Commercial legal persons only: limited companies (LTDA), corporations (S.A.), simple societies, single-member limited companies (EIRELI), public companies and mixed-capital companies, and cooperatives; sole traders (empresário individual, MEI included), non-profit entities, branches of foreign companies and every other natural-person form are never served. One record per CNPJ root, with the head office's 14-character CNPJ (shown 00.000.000/0001-91; the 8-digit root finds it too); branches are not served. Status is active, suspended, inapta (served as active_strike_off_pending), deregistered or merged; judicial recovery, bankruptcy, liquidation and intervention are read from the register's special situation, and there are no insolvency notices. The activity code is CNAE-Subclasses 2.3 (BR-CNAE-2.3), not a NACE code; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it; the secondary codes are in registry_details. No VAT number (a vat search is refused), and no partners, officers or contacts. Credit: Contains data from the Cadastro Nacional da Pessoa Jurídica (CNPJ), Receita Federal do Brasil, published as open data (CC BY). Adapted by Prometiam. Colombia: Company records from Confecámaras (RUES, the Colombian chambers of commerce): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly: the source's own update date is data_as_of and is in the credit. Companies of the commercial register only (S.A.S., Ltda., S.A., S. en C., S.C.A., collective companies, single-person companies (E.U.) and branches of foreign companies); natural persons, non-profit entities, cooperatives and public bodies are never served. The register has no address, share capital, contact, activity description or VAT number (a vat search is refused), and no liquidation state: liquidation, judicial liquidation and reorganisation are read from the company name and served as the status, and a cancelled registration is deregistered or merged. The registration may not be current although it reads active: last_renewal_year in registry_details is the last year it was renewed. company_name is the name without those markers and name_as_registered is the name as published. The activity code is the CIIU Rev.4 A.C. 4-digit code (CO-CIIU-REV4-AC), not a NACE code; a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. No insolvency notices. The records are offered under CC BY-SA 4.0 (share-alike). Credit: Contains data from Confecámaras (RUES, Registro Único Empresarial y Social), via the Portal de Datos Abiertos www.datos.gov.co, last updated on the date shown in data_as_of, licensed under CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/). Adapted by Prometiam; the adapted Colombian records are offered under CC BY-SA 4.0. Singapore: Company records from the Accounting and Corporate Regulatory Authority (ACRA): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated monthly. Local companies, limited liability partnerships (LLP) and registered foreign company branches only; sole proprietorships, general partnerships and limited partnerships are never served. Status includes liquidation, judicial management and receivership, and a struck-off, dissolved or amalgamated company is deregistered or merged; the corporate insolvency notices of the Singapore Government Gazette are served separately (/insolvency/search?country=SG) and linked to the record by the UEN. The register publishes no cessation date, share capital, GST (VAT) number (a vat search is refused), region or officers. The activity code is SSIC 2020 (5 digits, SG-SSIC-2020; a legacy 4-digit code carries no scheme); a NACE Rev. 2 class (or only the NACE division) is derived from it through ISIC Rev. 4 where the official tables allow, and nace_derived marks it. The annual return and accounts-due dates are in registry_details as published. API use of the data is licensed, not a right to the data itself. Credit: Contains information from ACRA Information on Corporate Entities and Entities Registered with ACRA accessed on the date shown in data_as_of from the Accounting and Corporate Regulatory Authority (ACRA) via data.gov.sg, which is made available under the terms of the Singapore Open Data Licence version 1.0 (https://data.gov.sg/open-data-licence). Adapted by Prometiam; not an official ACRA extract. Taiwan: Company records from the Ministry of Economic Affairs (GCIS) and the Ministry of Finance (Fiscal Information Agency): legal name, legal form, status, registered address, identifiers and dates; no officers or registry-compliance signal; register-change events (name, status, legal form and registered address, dated when the change first appears in the register data, none before the first load) and monitoring are available. Updated each working day. Limited companies, companies limited by shares, unlimited companies, limited partnership companies and Taiwan branches of foreign companies only; sole proprietorships, partnerships, domestic branches, cooperatives, associations and representative offices are never served. Names and addresses are in Chinese (the register publishes no English name; the English name of a company registered as an importer or exporter with the Bureau of Foreign Trade, about one in five since 21 Oct 2026, is in registry_details.name_en and is searchable in Latin letters). The responsible person is not served. Status includes dissolution, reorganisation, receivership and bankruptcy. The VAT number is the unified business number where the company is in the Ministry of Finance tax file (searchable with vat=), else null. The activity code is the Ministry of Finance tax industry code (6 digits, TW-TAX-SIC), which is not a NACE code, and the other codes of the file are in secondary_activity_codes. The check digit of the number is advisory. No officers; no insolvency notices. Credit: Contains data from the Ministry of Economic Affairs (Department of Commerce, GCIS; International Trade Administration, English names) and the Ministry of Finance (Fiscal Information Agency), Republic of China (Taiwan), released under the Open Government Data License, version 1.0 (https://data.gov.tw/license). Adapted by Prometiam, not a certified register extract. Czech Republic: Company records from the Czech public register (Veřejný rejstřík), kept by the regional courts and published by the Ministry of Justice as open data, with the region (kraj) and the activity code from the Czech Statistical Office Register of Economic Entities (RES): legal name, legal form, status, registered address, share capital, identifiers and dates; no officers, partners or shareholders and no registry-compliance signal; register-change events (name, status, legal form, registered address and share capital, dated when the change first appears in the register data, none before the first load, October 2026) and monitoring are available. Updated each working day. Commercial legal persons only (s.r.o., a.s., v.o.s., k.s., cooperatives, SE, SCE and EEIG); sole traders (OSVČ) and every other natural person, associations, foundations, trust funds, owners associations (SVJ) and branches are never served. Status includes liquidation, insolvency, bankruptcy and restructuring; there are no insolvency notices (the Czech Republic is not one of the sixteen insolvency markets) and no financial statements. No VAT number: a vat search is refused. The activity code is CZ-NACE 2025. The IČO has eight digits and its check digit is advisory, so companies whose IČO fails it are served. The registering court and file number (for example B 1581, Městský soud v Praze) are in registry_details. Credit: Contains data from the public registers of the Czech Republic (Ministry of Justice, ISVR open data) and the Czech Statistical Office (RES, CC BY 4.0). Adapted by Prometiam. Netherlands (NL): LEI-registered entities with a KVK number (GLEIF golden copy, CC0 1.0), not the Dutch commercial register (Handelsregister, KVK); company number = the 8-digit KVK number, lei a second identifier; BV, NV, SE, cooperatives, SCE, OWM, CV and VOF only, no sole proprietorships, foundations, associations, public bodies, funds or branches; no officers, share capital, activity code, VAT number or financials; register-change events (none before 30 Oct 2026) and monitoring. Credit: Contains LEI data from GLEIF, available under CC0 1.0. LEI-registered entities only; not an extract of the Dutch commercial register (Handelsregister, KVK). Germany (DE): LEI-registered entities (Global Legal Entity Identifier Foundation, GLEIF golden copy), plus companies listed in the energy market register (Marktstammdatenregister, Bundesnetzagentur) with their commercial-register entry that no LEI record holds; not the German commercial register (Handelsregister). The second source is a partial layer declared by the market actors and not checked against the commercial register: status null (local_status unknown), no founding date, no register-change events; registry_details.source is gleif or mastr. Company records only: the company number is the 20-character LEI (ISO 17442 check) or, for the energy market register, the commercial-register entry with the court (HRB12653/FRANKFURT-AM-MAIN), searchable with company_number, lei, or register_number (HRB12653, optional register_court); no officers, share capital, activity code or VAT number (a vat search is refused), no registry-compliance signal and no financial statements; register-change events for the LEI-registered entities (name, status, legal form, registered address, none before the first load, October 2026) and monitoring are available. Updated daily. GmbH, UG (haftungsbeschränkt), AG, KGaA, SE, OHG, KG (including GmbH & Co. KG), eG and PartG only; sole traders (e.K.) and other natural persons, GbR, associations (e.V.), foundations, public-law bodies, funds and branches are never served. Status is active, deregistered or merged; the LEI's own renewal status is registry_details.lei_status; the register court, register type and number (for example Amtsgericht München, HRB) are in registry_details. German corporate insolvency notices are served separately (Germany is one of the sixteen insolvency markets) and are not linked to these records. Credit: Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. Not an extract of the German commercial register (Handelsregister). Energy market register records also carry: Contains data from the Marktstammdatenregister of the Bundesnetzagentur (https://www.marktstammdatenregister.de/MaStR/Datendownload), licensed under the Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0, https://www.govdata.de/dl-de/by-2-0). Data changed: selected, joined and normalised by Prometiam. Ukraine (UA): company records from the Unified State Register of Legal Entities, Individual Entrepreneurs and Public Organisations (EDR) of the Ministry of Justice of Ukraine, updated weekly: legal name (in Ukrainian), legal form, status (including liquidation and bankruptcy proceedings), registration and termination dates, share capital (UAH) and the EDRPOU code, which is the company number (8 digits, leading zeros kept, for example 21673832; the check digit is advisory and a 10-digit number is refused). Register-change events (name, status, legal form and share capital, dated when first seen in the register data, none before the launch in October 2026) and monitoring are available. No officers, founders or beneficial owners, no registry-compliance signal, no address, activity code or contacts (withheld by the Ministry since martial law was introduced), no VAT number (a vat search is refused), no financial statements and no insolvency notices; commercial legal persons only, ended ones included, and individual entrepreneurs (FOP) and other natural persons, farms, associations, parties, unions, religious and charitable bodies, public bodies and branches are never served; some state and defence-related entities are not in the open data. Credit: Contains data from the Unified State Register of Legal Entities, Individual Entrepreneurs and Public Organisations (EDR), Ministry of Justice of Ukraine, published as open data on data.gov.ua under the Creative Commons Attribution licence (CC BY 4.0). Adapted by Prometiam. Serbia (RS): company records from the Register of Business Entities kept by the Business Registers Agency of the Republic of Serbia (APR), read from its Open Data API and updated monthly (the register is published as a snapshot cut at month-end, and data_as_of is that cut): legal name, legal form, status (including liquidation, forced liquidation and bankruptcy), the municipality as the city (in Latin letters), the date of establishment and the KD 2010 activity code, from which nace_class is read. Register-change events (name, status, legal form and address, which is the municipality; dated when first seen in the register data, none before the launch in October 2026; the first come with the next monthly snapshot) and monitoring are available, and a deregistration raises a dissolution alert dated by the check that first sees it, as the register gives no dissolution date. The matični broj (8 digits, leading zero kept, for example 17204106) is the company number; its check digit is enforced and a 13-digit number (a JMBG, a personal number) is refused. No officers, street address, share capital or registry-compliance signal, no VAT (PIB) number (a vat search is refused), no financial statements and no insolvency notices; companies of the Register of Business Entities only (d.o.o., a.d., o.d. and k.d.), and entrepreneurs, cooperatives, public enterprises, branches and representative offices of foreign companies, associations and foundations are never served. Credit: Contains data from the Business Registers Agency of the Republic of Serbia (Агенција за привредне регистре, APR), Open Data API (https://openapi.apr.gov.rs/api/opendata/companies), published under the Serbian Open Data Licence (https://data.gov.rs/sr/terms/). Adapted by Prometiam (status and legal form normalised, municipality names transliterated to Latin, whitespace in names normalised). Ecuador (EC): company records from the company directory of the Superintendencia de Compañías, Valores y Seguros (SCVS), the Ranking de Compañías, joined on the RUC with the Catastro RUC of the Servicio de Rentas Internas (SRI): legal name, legal form, status (the state of the RUC with the SRI: active, suspended or deregistered; in liquidation where the name carries the legal marker; a company the SRI file does not list yet has no status yet (status null, local_status unknown)), the canton as the city, the start of activities and the CIIU Rev. 4 activity code (the NACE class or division derived through ISIC Rev. 4); register-change events (name, status, legal form and canton, dated when first seen in the register data, none before the Ecuador launch; the first with the next monthly SRI snapshot) and monitoring; no officers, street address, share capital, registry-compliance signal, VAT number (the RUC is the tax number; a vat search is refused), financial statements or insolvency notices; companies of the SCVS list only, in its nine company forms, and associations or consortia and every natural person are never served, while banks, insurers, cooperatives and public enterprises are not in the list; updated monthly. Credit: Contains data from the Superintendencia de Companias, Valores y Seguros (SCVS) of Ecuador, company directory of the Ranking de Companias (https://appscvsmovil.supercias.gob.ec/ranking/), and from the Servicio de Rentas Internas (SRI) of Ecuador, Catastro RUC open data (https://www.sri.gob.ec/datos-abiertos), which the SRI publishes under a Creative Commons Attribution (CC BY) licence. Adapted by Prometiam (joined on the RUC, status derived); not an official register extract. Chile (CL): company records from the Registro de Empresas y Sociedades (RES), Ministerio de Economía, Fomento y Turismo, published on datos.gob.cl, only the companies registered under the simplified regime of Ley 20.659 since 2013, not the whole Chilean register (SpA, SRL, SA and SAGR; one-person companies, partnerships and natural persons are never served): legal name, legal form, the comuna as the city and the region, the date the constitution was entered and the capital at constitution in Chilean pesos; no status, officers, street address, activity code, VAT number (the RUT is the tax number; a vat search is refused), financial statements or insolvency notices; no register-change events and no monitoring; the RUT is the company number; updated monthly. Credit: Contains data from the Registro de Empresas y Sociedades (RES) of the Ministerio de Economía, Fomento y Turismo of Chile, companies registered under the simplified regime of Ley 20.659 since 2013, published on datos.gob.cl (https://datos.gob.cl/dataset/registro-de-empresas-y-sociedades) under the Creative Commons Attribution (CC BY) licence. Adapted by Prometiam (companies only, one record per company, region names and dates normalised); not the whole Chilean register and not an official register extract.

Install

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

Configure

It 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 credits — 14-day free trial: 500 credits; a card is required, nothing is charged for 14 days — 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_..."

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:

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

Cursor (.cursor/mcp.json in the project, or ~/.cursor/mcp.json):

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

VS Code (.vscode/mcp.json; the key is servers, and 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 (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.

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

That config runs on the shared demo key, no signup. To use your own key, add "env": { "PROMETIAM_API_KEY": "rk_live_..." } next to args (an empty value or the placeholder rk_live_your_key_here is ignored and the demo key is used).

Restart Claude Desktop. The 36 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"]    }  }}

Use with Continue

Add to ~/.continue/config.json under experimental.modelContextProtocolServers:

{  "experimental": {    "modelContextProtocolServers": [      {        "transport": {          "type": "stdio",          "command": "npx",          "args": ["-y", "prometiam-risk-mcp"]        }      }    ]  }}

Use with any other MCP client

Anything that speaks MCP over stdio works. Run the binary; set PROMETIAM_API_KEY in the environment only when you have your own key. JSON-RPC requests on stdin, responses on stdout, logs on stderr.

Environment variables

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 36 tools and their schemas.

Rate limits & pricing

Per Prometiam tier (returned in every response's meta.rate_limit). Every successful call costs credits (0 for account and coverage, 1 for a company search or record, 2 for corporate events, people, director network, insolvency and procurement, 3 for a sanctions screen per name, 25 for one company's financial statements); errors cost nothing, and each response states its cost in the X-Credits-Cost header:

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 mutating tools are monitor_subscribe, monitor_stop, sanctions_watch and sanctions_unwatch (create or delete a monitoring subscription or a sanctions watchlist entry 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/mcp for the install page, or https://www.prometiam.com?utm_source=npm&utm_medium=readme for terms.

• API documentation: https://www.prometiam.com/risk-api/docs?utm_source=npm&utm_medium=readme
• OpenAPI 3.0 spec: https://www.prometiam.com/openapi.json
• Pricing: https://www.prometiam.com/pricing?utm_source=npm&utm_medium=readme
• Support: https://www.prometiam.com/contact

License

MIT © Prometiam