BORME API

com.bormeapi/borme-mcp · v1.2.0 · finance-and-payments

BORME API is healthy: it completed an MCP handshake in 1196 ms and exposes 10 tools.

Spain's company registry gazette (BORME): more than 9.6 million events since 2009. API key or OAuth.

Endpoint: https://mcp.bormeapi.com/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count10
Latency1196 ms
Last checked (UTC)2026-10-30T01:05:23.373Z

Health history

Checked (UTC)StatusLatencyError
2026-10-30T01:05:23.373ZHealthy1196

Tools (10)

search_eventsSearch Spanish commercial-registry (BORME) events, newest first, as JSON. All filters are optional (see each parameter); coverage starts in 2009. Returns at most `limit` events. Barcelona prints some acts as free text under "Otros conceptos": recognised wording gets its own act type (act_type_raw
company_historyRegistry timeline for one company, as JSON. `company` is a slug or a name; a name with several matches returns the candidate slugs instead. An older slug of a merged company returns the merged company's whole timeline: company_slug is the current slug, former_slugs the others, and each event keeps
company_by_nifLook up a Spanish company by its NIF/CIF tax ID. Needs the basic plan or higher: send your API key in the X-API-Key header (https://bormeapi.com/account). BORME itself has no dedicated tax-ID field: the mapping is cross-referenced from open official sources and, in some cases, taken from the text
brand_ownerFind the Spanish company a brand or trading name is linked to, by holder name. Searches the patent office's trademarks and commercial names (1987 to today), which BORME does not print, and returns for each the company whose name matches the holder name the office published. `commercial_name` ident
company_brandsTrademarks and trading names linked to one company by name (slug from company_history). Answers "which trading names and trademarks does the patent office list under a holder of this company's name". The office publishes no tax IDs, so every link is a name match, not confirmed ownership. Commercial
recent_signalsSample of the latest derived risk signals (last 7 publication days, max 10 rows). Types: INSOLVENCY_FILED, ACCORDION, MASS_EXIT, OWNERSHIP_CHANGE, DISTRESS_COMBO, PHOENIX, ADDRESS_CLUSTER, AEAT_DEBTOR, PUBLIC_CONTRACT_AWARD. AEAT_DEBTOR comes from the AEAT's yearly debtors list (art. 95 bis LGT): d
daily_digestDigest of one BORME publication day: totals by event type, top provinces, and `insolvencies`: every event of the day whose act types include INSOLVENCY_DECLARATION or INSOLVENCY_STATUS, with company and province only (SUSPENSION_OF_PAYMENTS, BANKRUPTCY_LEGACY and PROVISIONAL_SHEET_CLOSURE_INSOLVENCY
search_companiesFind Spanish companies by name and return ranked company cards (slug, status, province). Use it first when the user gives a company name, then company_history with the slug. Matches current names, former names and name variants, ignoring accents, case, punctuation and the legal form. Each card's `m
list_act_typesAll normalized event types: the enum (act_type), the original Spanish label (spanish) and its English label (english).
registry_statsCoverage and freshness report for the BORME dataset behind this server. Returns a JSON object with: events_approx and companies_approx (planner estimates, not exact tallies), coverage {from, to} (first and latest publication day held, YYYY-MM-DD), parse_completeness_last_30d (share of gazette text