{"id":"com.bormeapi/borme-mcp","slug":"com-bormeapi-borme-mcp","title":"BORME API","description":"Spain's company registry gazette (BORME): more than 9.6 million events since 2009. API key or OAuth.","version":"2.1.0","publisher":{"kind":"domain","id":"bormeapi.com","label":"bormeapi.com","url":"https://bormeapi.com"},"website":"https://bormeapi.com/mcp","repository":"https://github.com/bormeapi/borme-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.bormeapi.com/mcp","headers":[{"description":"Your BORME API key. Leave it out to use the free plan.","isSecret":true,"name":"X-API-Key"}]},{"type":"streamable-http","url":"https://mcp.bormeapi.com/mcp/oauth"}],"packages":[],"published":"2026-10-30","updated":"2026-10-30","status":"online","auth":"","latency_ms":1267,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_events","title":"Search registry events","description":"Search BORME registry events (since 2009) across companies by publication\ndate, province, act type and company name, newest first or oldest first.\n\nUse it for questions about many companies. For one known company use company_history; to find a\ncompany use search_companies; for one day's totals use daily_digest.\n\nReturns JSON {count, events: [{event_id, date, borme_id, province,\ncompany_name, compa","read_only":true},{"name":"company_history","title":"Company registry timeline","description":"Get one company's BORME timeline: its published registry events within your\nplan's window.\n\nUse it once the company is known (a slug from search_companies or\ncompany_by_nif); across many companies use search_events. A name is\nsearched too: several matches return {ambiguous: true, candidates}, none\nreturns {error, suggested_companies}.\n\nReturns JSON {company_slug, total_events, first_seen, last_see","read_only":true},{"name":"company_snapshot","title":"Company registry card","description":"Get a company registry card, as in REST API GET /v1/companies/{slug}.\n\nUse it for officers (current roles from published acts), sole_shareholder\nas printed, capital_eur, address, status, NIF with its source, public_contracts\nand a size_hint estimate. For dated acts use company_history.\nNames are searched as in company_history: multiple matches return\n{ambiguous: true, candidates, candidate_names w","read_only":true},{"name":"company_signals","title":"A company's signals","description":"Get one company's derived signals within your plan's window, newest first:\nthe REST API's GET /v1/companies/{slug}/signals.\n\nUse it for one company's ownership changes, mass exits, insolvency\ndeclarations and the like; across all companies use recent_signals. A name\nis searched as in\ncompany_history: several matches return {ambiguous: true, candidates},\nnone returns {error, suggested_companies}.\n\n","read_only":true},{"name":"company_by_nif","title":"Find a company by NIF","description":"Look up a company by NIF/CIF. Use it for a tax ID; for names,\nsearch_companies. On a hit, call company_history with company_slug.\n\nReturns {found, company_slug, current_name, website, lei, nif_caveat, ...}; use\ncurrent_name. lei: GLEIF Legal Entity Identifier matched by NIF; null means\nno match yet. website: newest BORME website act; null if none or\nremoved.\n\nBORME has no dedicated tax-ID field: m","read_only":true},{"name":"vat_check","title":"Check an EU VAT number in VIES","description":"Check whether a VAT number was valid for intra-EU transactions according\nto VIES, the European Commission's VAT Information Exchange System, on\nrequest_date. Results are cached for 24 hours. Use it when the user asks\nwhether a VAT number (NIF-IVA) is valid for intra-EU trade. For a Spanish\nNIF, use company_by_nif to look for a company with that NIF in our registry.\n\nReturns JSON {vat_number, count","read_only":true},{"name":"brand_owner","title":"Find a brand's company","description":"Find the Spanish company a trademark or trading name is linked to, in the\nSpanish patent office (OEPM) records we hold (since 1987).\n\nUse it when the user names a brand; for a company's own name use\nsearch_companies, for a known company's brands use company_brands.\n\nReturns JSON {found, brand, matches: [{brand, kind, company_slug,\ncompany_name, company_status, file}], truncated, source, note}: one","read_only":true},{"name":"company_brands","title":"A company's brands","description":"List the trademarks and trading names that the Spanish patent office (OEPM)\nrecords under a holder with this company's name.\n\nUse it with a slug from search_companies or company_history; to go from a\nbrand to its company use brand_owner.\n\nReturns JSON {company_slug, commercial_names, trademarks (each {name, file,\nstatus, since}), counts, truncated, limit_per_kind, source, note}: one\nentry per OEPM","read_only":true},{"name":"company_grants","title":"A company's public aid (BDNS)","description":"List the public aid awards that BDNS, Spain's national database of\nsubsidies and other public aid, records for a company's tax ID, newest\nfirst.\n\nUse it for a known company (a slug from search_companies).\n\nReturns JSON {company_slug, nif, link, shown_from, data_as_of, attribution,\ntotals {by_instrument, by_year}, count, next_offset, truncated, items\n[{concession_id, granted_on, instrument, amount_","read_only":true},{"name":"company_contracts","title":"A company's public contract awards","description":"List a company's public contract awards, ordered by publication date,\nnewest first: the REST API's GET /v1/companies/{slug}/contracts.\n\nUse it for one company's awards; a name is searched as in company_history:\nseveral matches return {ambiguous: true, candidates}, none returns\n{error, suggested_companies}.\n\nReturns JSON {company_slug, nif, count, offset, next_offset, contracts:\n[{source, award_id,","read_only":true},{"name":"recent_signals","title":"Recent risk signals","description":"Get a sample of the latest risk signals derived from BORME and public\nsources: at most 10 rows dated within the last 7 days.\n\nUse it for \"what risk signals appeared this week\"; not a per-company check\n(use company_history) and not the full feed (the hosted API's\n/v1/signals).\n\nReturns JSON {count, window, sample_cap, signals: [{signal_type, date,\ncompany_slug, company_name, province, details}], fu","read_only":true},{"name":"daily_digest","title":"Daily BORME digest","description":"Summarise one BORME publication day: total events, counts by act type, the\ntop 10 provinces and the day's insolvency-proceedings notices.\n\nUse it for \"what was published today\" or a day's figures; to read the\nnotices use search_events with date_from = date_to = that day.\n\nReturns JSON {date, total_events, by_type, top_provinces, insolvencies:\n[{company, province}]}. insolvencies lists the events w","read_only":true},{"name":"act_stats","title":"Act counts by type, period and province","description":"Count BORME acts by act type, period (month, quarter or year) and\nprovince: how many companies and entries had mergers, spin-offs, capital\nincreases or any other act type, newest period first.\n\nUse it for trends (\"mergers per quarter in Spain since 2020\"). To read\nthe acts themselves use search_events.\n\nReturns JSON {grain, count, truncated, rows: [{period, act_type, province,\ncompanies, events}],","read_only":true},{"name":"search_companies","title":"Search companies by name","description":"Find Spanish companies by name and return ranked company cards. Use it first\nwhen the user gives a company name, then company_history with its\ncompany_slug; with a tax ID use company_by_nif, with a brand use\nbrand_owner.\n\nMatches current names, former names and variants, ignoring accents, case,\npunctuation and the legal form. Returns JSON {query, count, total,\ntotal_is_at_least, truncated, limit, ","read_only":true},{"name":"list_act_types","title":"List act types","description":"List every normalized BORME act type: the enum used by the act_types filter\nof search_events (act_type), its Spanish label (spanish) and its English\nlabel (english).\n\nUse it to choose act_types values or to translate act types in an answer; it\nreads no registry data. Returns a JSON array of {act_type, spanish,\nenglish}, sorted by act_type. Read-only, open to everyone, no key needed\nand not counted","read_only":true},{"name":"registry_stats","title":"Data coverage and freshness","description":"Report the coverage and freshness of the BORME data behind this server.\n\nUse it to answer \"how much data is there?\", \"how fresh is it?\" and \"can I\ntrust date filters for period X?\" before running searches; it says\nnothing about any one company.\n\nReturns JSON {events_approx, companies_approx, coverage: {from, to},\nparse_completeness_last_30d, source}: exact event and company counts\nfrom the latest ","read_only":true},{"name":"company_group","title":"A company's identified sole-shareholder network","description":"Get a company's sole-shareholder network from links with no ending\nidentified in available BORME publications. Links do not establish\ncurrent ownership, control or a legal group. Use it for identified sole\nshareholders or connected companies; use group_history for events. Name\nlookup: multiple matches return {ambiguous: true, candidates}; none\nreturn {error, suggested_companies}.\n\nReturns {company","read_only":true},{"name":"group_history","title":"Registry events of the identified sole-shareholder network","description":"Get the BORME events of every company in the identified sole-shareholder\nnetwork (as company_group returns it), newest first, within your plan's\nwindow.\n\nUse it before a visit (\"which BORME events were published this year for\ncompanies in X's identified sole-shareholder network\") or for the\npublished mergers, demergers and capital changes concerning companies in\nthe identified network; for one com","read_only":true}],"server_info":{"icons":[{"mimeType":"image/png","sizes":["512x512"],"src":"https://bormeapi.com/icon-512.png"}],"name":"borme","title":"BORME API","version":"0.1.0","websiteUrl":"https://bormeapi.com/mcp"},"category":"web-search","tags":["legal"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-29","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/com-bormeapi-borme-mcp/"}