bots.st/borme-api
BORME API
Search and summarize Spanish registry events
1104 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 13
- Answered
- 4 of the last 4 calls
How to reach it
- MCP, HTTP
https://mcp.bormeapi.com/mcp - MCP, HTTP
https://mcp.bormeapi.com/mcp/oauth
What it can do
| Tool | What it says it does |
|---|---|
act_stats | Count BORME acts by act type, period (month, quarter or year) and province: how many companies and entries had mergers, spin-offs, capital increases or any other act type, newest period first. Use it for trends ("mergers per quarter in Spain since 2020"). To read the acts themselves use… |
brand_owner | Find the Spanish company a trademark or trading name is linked to, in the Spanish patent office's (OEPM) trademark and commercial-name records we hold (the archive starts in 1987). Use it when the user names a brand; for a company's own name use search_companies, for a known company's brands use… |
company_brands | List the trademarks and trading names that the Spanish patent office (OEPM) records under a holder with this company's name. Use it for a known company (a slug from search_companies or company_history); to go from a brand to its company use brand_owner. Returns JSON {company_slug… |
company_by_nif | Look up a Spanish company by its NIF/CIF tax ID. Use it when the user gives a tax ID (with a name use search_companies); on a hit, call company_history with company_slug. Returns JSON {found, company_slug, current_name, status, nif_source, nif_caveat, ...}; use current_name. BORME has no… |
company_history | Get one company's BORME timeline: its published registry events within your plan's window. Use it once the company is known (a slug from search_companies or company_by_nif); across many companies use search_events. A name is searched too: several matches return {ambiguous: true, candidates}… |
company_signals | Get one company's derived signals within your plan's window, newest first: the REST API's GET /v1/companies/{slug}/signals. Use it for one company's ownership changes, mass exits, insolvency declarations and the like; across all companies use recent_signals. A name is searched as… |
company_snapshot | Get one company's current registry card: the same answer as the REST API's GET /v1/companies/{slug}. Use it for "who runs it, who owns it, what capital": officers (the current roles derived from the published acts), sole_shareholder as printed, capital_eur, address, status, NIF with its source… |
daily_digest | Summarise one BORME publication day: total events, counts by act type, the top 10 provinces and the day's insolvency-proceedings notices. Use it for "what was published today" or a day's figures; to read the notices use search_events with date_from = date_to = that day. Returns JSON {date… |
list_act_types | List every normalized BORME act type: the enum used by the act_types filter of search_events (act_type), its Spanish label (spanish) and its English label (english). Use it to choose act_types values or to translate act types in an answer; it reads no registry data. Returns a JSON array of… |
recent_signals | Get a sample of the latest risk signals derived from BORME and public sources: at most 10 rows dated within the last 7 days. Use it for "what risk signals appeared this week"; not a per-company check (use company_history) and not the full feed (the hosted API's /v1/signals). Returns JSON {count… |
registry_stats | Report the coverage and freshness of the BORME data behind this server. Use it to answer "how much data is there?", "how fresh is it?" and "can I trust date filters for period X?" before running searches; it says nothing about any one company. Returns JSON {events_approx, companies_approx… |
search_companies | Find Spanish companies by name and return ranked company cards. Use it first when the user gives a company name, then company_history with its company_slug; with a tax ID use company_by_nif, with a brand use brand_owner. Matches current names, former names and variants, ignoring accents… |
search_events | Search BORME registry events (since 2009) across companies by publication date, province, act type and company name, newest first. Use it for questions about many companies ("insolvency notices in Valencia in September"). For one known company use company_history; to find a company use… |
In its maker's words
Spain's company registry gazette (BORME): more than 9.6 million events since 2009. API key or OAuth.
- Website
- bormeapi.com/mcp
- Source
- github.com/bormeapi/borme-mcp
- Publisher
- bormeapi.com
- Listed from
- the official MCP Registry as
com.bormeapi/borme-mcp - Version
- 2.1.0, updated 30 Oct 2026
- Kinds of work
- Search and research, Law, tax and government, Data and databases
The domain it lives on
- bormeapi.com
- registered 6 Jul 2026 (4 months ago), at GoDaddy.com, LLC, its home page is a working site
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 1104 ms | |
| Answered | 1580 ms | |
| Answered | 596 ms | |
| Answered | 596 ms |
Next door
Is this your bot? Claim its address to add a verified badge and keep the listing current.