Prometiam Risk Intelligence
v0.4.69Company data and KYB API for 44 countries: monitoring, financial statements, insolvency, sanctions
Endpoint health
online- Last checked
- 11/20/2026, 5:16:12 AM
- Latency
- 279 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.prometiam%2Frisk-mcp
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.prometiam/risk-mcp": {
"url": "https://api.prometiam.com/functions/v1/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
25 shown · authentication unknown
Get account and credits
account
Returns the calling API key's account info and current usage: plan tier, rate limits (per minute in requests, per day / month in credits), credits used and left, and enabled scopes. It also returns the purposes declared for the account and for this key (declared_purposes, key_purposes; null until declared) and the legal documents the account accepted (accepted_documents: document, version, day, link). Costs no credits. Use this to check "how many credits do I have left?".
Schema valid · SHA-256 dc8590c2e6e4…
View input schema
{ "type": "object", "properties": {}, "$schema": "http://json-schema.org/draft-07/schema#" }Bulk company lookup
companies_lookup
Resolve up to 100 companies in ONE call (POST /companies/lookup). Each item needs country plus an identifier (company_number; aliases nif, siren, vat) or a name (best fuzzy match with match_score; exact only: no similar-spelling fallback and no other-letter NIF). Results come back in request order with status found / not_found / error / timeout and the same company object companies_search returns. Every item costs 1 credit; a batch that does not fit is refused with 429 batch_exceeds_quota and max_items_now. Optional idempotency_key: replaying the same key with the same items within 24h returns the original response for free (409 if still running, 422 if the items differ).
Schema too-large · SHA-256 839711cd64a0…
Search companies
companies_search
Search companies in official registries by name or identifier. Every company is one standard object with the same keys in all 38 countries (null where the register publishes no value): identifiers [{type, value}], vat_number and vat_number_source (register or rule; also in identifiers as type vat; `register`: published by the register (EE; LV from the State Revenue Service’s list of VAT payers; SK from the Financial Administration’s list of VAT payers; LT from the State Tax Inspectorate’s list; JP the T-number from the register of qualified invoice issuers kept by the National Tax Agency, while the registration is in force; AU the ABN while GST-registered; TW the unified business number where the company is in the tax file) or the register confirms VAT registration and the number is the legal format of its identifier (NO, FI, BE). `rule`: built from the company identifier (ES `ES`+NIF, FR `FR`+key+SIREN, PL `PL`+NIP, NO `NO`+number+`MVA`, FI, SE `SE`+number+`01`, BE, HR `HR`+OIB, DK, RO `RO`+CUI, CH `CHE`+UID+`MWST`): the format is right, the registration is not confirmed (check an EU number with `GET /vat/{number}`; VIES has no NO or CH). Null where the register says the company is not VAT-registered (NO, FI), where a Latvian company is not on the State Revenue Service’s list of VAT payers, where a Slovak company is not on the Financial Administration’s list of VAT payers, where a Japanese company is not a qualified invoice issuer or its registration was cancelled or has expired, and where no rule exists (GB, IE, CY, US, CA, IL, BR, CO, SG, CZ, DE, IT, IN, AT, GR, LU, HU, PT, JE, MX, SI, and EE without a published KMKR).), the standard legal_form abbreviation and legal_form_family beside the register's local_legal_form and local_legal_form_name, a standard status and stage, status_group (active or inactive) and status_qualifier (rescue_plan, insolvency_proceedings, administratively_non_compliant, bankruptcy, in_liquidation, dissolved, dissolved_merger, dissolved_demerger, administratively_suspended, inactive) beside the register's own local_status (both are read from the register's own status and never inferred from silence: the qualifier is null for an ordinary active company and wherever the register does not say; a rescue plan only where the stored status says so; administratively_suspended only for Brazil's suspended registrations, not a pause the company asked for; Australia's external administration serves no group; dormant, reorganization, default of payment and a dissolution that followed a bankruptcy or a liquidation are not served), one main activity_code with its scheme, label and NACE class (nace_class, nace_version, nace_division, nace_derived, and nace_title, its English title), the same industry as a NACE Rev. 2 and a NACE Rev. 2.1 class or division (nace_rev2_class, nace_rev2_division, nace_rev21_class, nace_rev21_division), the ISIC Rev. 4 class (isic4_class) and the US NAICS 2022 sector and subsector (naics_sector, naics_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, never a guess and never read from the name; ES and PL mix two editions of their classification, so a class that exists in both revisions with changed content is served only when both readings give it; BR, CO and SG derive from ISIC Rev. 4), each code with its English title as the official table words it (nace_rev2_title, nace_rev21_title, isic4_title, naics_sector_title, naics_subsector_title: the title of the class, or of the division where only the division is served; null exactly when the code is), and the age of the company: age_years (whole years on the day of the answer), age_band (under_1y, 1_3y, 3_5y, 5_10y, 10_20y, 20y_plus) and age_basis (founding_date, else registration_date; null for CH and JP, which publish no founding date, for DE, which serves no founding date, and for SI, whose open list carries no date; in an LEI layer the date is the entity creation date GLEIF holds, which can be later than the start of the company), name_latin and name_latin_basis (the Latin-letter name, upper case, of a company whose register writes its legal name in another script, and where it comes from: register, gleif or romanisation; never a translation; null when the legal name is already in Latin letters or no Latin name exists; served for JP, IL, TW, CY, UA, RS, GR and the LEI layers; Hebrew, Chinese and Korean are never romanised, so IL and TW have one only where the register or GLEIF holds one; a Ukrainian name with Russian letters has none; a search in Latin letters also finds the company by it), address with region, capital_amount and capital_eur, and registry_details for what only one register has (null when the dictionary does not recognise a stored value — never a guess), and advertising_protected (Denmark: the CVR register mark that the company asked not to be contacted for direct marketing, CVR act s.19; true means do not use the record for direct marketing, false means the register states no protection, null for other countries and where the register holds no mark yet; the company is served either way). Use country to scope the search to Spain (BORME), France (BODACC), the UK (Companies House), Ireland (CRO), Poland (KRS), Norway (Brønnøysundregistrene), 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), Brazil (CNPJ), Colombia (RUES), Singapore (ACRA), Taiwan (GCIS), the Czech Republic (public register, Ministry of Justice, and RES), Germany (LEI-registered entities and energy-market register companies), Mexico (LEI-registered entities and the companies of INEGI's DENUE directory, not the company register), or the United States (state registers, SEC EDGAR and GLEIF). Fuzzy name results carry a match_score (0–100) and are ranked by relevance, best first. NOTE: "dissolved" means different things by country — ES/FR still exists pending liquidation, GB/IE/PL/NO/FI no longer exists — read status (the standard value), not local_status, to compare across countries. Norway and France include sole proprietorships (ENK, EI) as the register publishes them; a French company that opted out of publication (INSEE non-diffusible) has company_name null, status withheld and registry_details.non_diffusible true, is left out of name searches, the founding-date feed and event searches by name, and is found by SIREN or SIRET. Every French company carries registry_details.diffusion_status, the Sirene status of the company: O diffusible, P partially diffusible (the company or its owner restricted the diffusion of its data, art. A.123-96 of the Code de commerce), null while not read yet; a P company has no address and no postal code, and a sole proprietorship that INSEE lists without a name is served like a non-diffusible company. A Spanish company closed by a merger is served as closed (local_status absorbed). A malformed identifier (a Spanish NIF must pass its control character), or a limit outside the documented range, is a 400 validation_error. A name search ranks a pool of up to about 700 candidates and pages through it: when has_more is true, pass next_cursor (o:<n>) back as cursor (offset=<n> is the same), 1 credit a page; a page past the pool is empty. match_score (0-100) means the same in every country: 100 the name is the query, 80-99 it starts with the words of the query, 50-79 it holds every word, below 50 parts of words. match_type on every result says what it matched on: exact (the identifier, the whole name, or a listing with no name), partial (the name starts with or h
Connections
streamable-http
https://api.prometiam.com/functions/v1/mcp