{"data":{"name":"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","websiteUrl":"https://bormeapi.com/mcp","repositoryUrl":"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":[],"status":"active","isLatest":true,"publishedAt":"2026-10-30T02:13:39.418Z","updatedAt":"2026-10-30T02:13:39.418Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"com.bormeapi/borme-mcp","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-10-30T02:13:39.418Z","title":"BORME API","description":"Spain's company registry gazette (BORME): more than 9.6 million events since 2009. API key or OAuth.","websiteUrl":"https://bormeapi.com/mcp","repositoryUrl":"https://github.com/bormeapi/borme-mcp"}],"toolIndex":{"tools":[{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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}], data_through, built_from, built_to, note,\nplan_window}, plus hidden_by_plan when the plan left buckets out, and\nnot_built (no rows, never zeros) when the range reaches years outside\nbuilt_from..built_to. period is the bucket's first day by BORME\npublication date. companies counts distinct companies in that bucket:\nnever add rows up. Province \"*\" is all of Spain; a community gives one row\nper province, not a total.\n\nRead-only; one request per call. Needs the pro plan or higher: send your\nkey in the X-API-Key header (https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"act_types":{"title":"Act Types","items":{"type":"string"},"type":"array","description":"Optional list of act type enums to count, e.g. [\"MERGER_BY_ABSORPTION\", \"TOTAL_SPIN_OFF\"]; omit for every act type. Full list: list_act_types."},"provinces":{"title":"Provinces","items":{"type":"string"},"type":"array","description":"Optional list of BORME province names, accent- and case-insensitive, e.g. [\"MADRID\", \"BARCELONA\"]; an autonomous community gives one row per province, e.g. [\"Cataluña\"]. Omit for the all-provinces rows (province \"*\")."},"by_province":{"default":false,"title":"By Province","type":"boolean","description":"Without provinces: true gives one row per province instead of the all-provinces rows, e.g. true (default false)."},"grain":{"default":"month","enum":["month","quarter","year"],"title":"Grain","type":"string","description":"The length of each period, one of \"month\" (default), \"quarter\", \"year\", e.g. \"quarter\"."},"date_from":{"title":"Date From","type":"string","description":"Optional YYYY-MM-DD, e.g. 2024-01-01; the period holding this day is the first one. Data starts on 2009-01-02."},"date_to":{"title":"Date To","type":"string","description":"Optional YYYY-MM-DD, e.g. 2025-12-31; periods starting on or before this day."},"limit":{"default":1000,"title":"Limit","type":"integer","maximum":5000,"description":"Maximum rows, integer 1-5000, e.g. 200 (default 1000); truncated is true when more matched."}},"title":"act_statsArguments"},"annotations":{"title":"Act counts by type, period and province","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"24e219021fe101ee988834347e609dbc63f9909b75808526b723dca90890997b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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 match\nper company and name; file is that name's newest OEPM file. kind\ncommercial_name identifies a business; trademark distinguishes goods or\nservices (NESCAFÉ is not another name for Nestlé): say which kind a hit is.\nLinks are holder-name matches (no tax IDs are published); ambiguous holders\nstay unlinked: present a hit as a name match, not confirmed ownership.\nfound false is not proof the brand is unused. On a hit, use company_history\nwith the slug.\n\nRead-only; one request per call. Needs the basic plan or higher: send your\nAPI key in the X-API-Key header (https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"brand":{"title":"Brand","type":"string","description":"Brand or trading name, or part of it, at least 3 letters or digits after punctuation is removed, case-insensitive, e.g. \"ZARA\"."},"limit":{"default":20,"title":"Limit","type":"integer","maximum":200,"description":"Maximum matches, integer 1-200, e.g. 10 (default 20)."}},"required":["brand"],"title":"brand_ownerArguments"},"annotations":{"title":"Find a brand's company","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"d3e38a51a4367f326a2bebdcd68e88a790fa2a13ef0e384a2d42c69b6e8a5472","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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 file, so a name can repeat, the company's own name included.\nNo tax IDs are published: each link is a name match, not confirmed\nownership. An empty list means none is linked in our data, not that the\ncompany holds none; {error, suggested_companies} means an unknown slug:\nnothing was looked up. limit applies per kind, newest first; counts is what\nthis answer lists, not the company's total, and truncated true for a kind\nmeans more are linked: raise limit.\n\nRead-only; one request per call. Needs the basic plan or higher: send your\nAPI key in the X-API-Key header (https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"company":{"title":"Company","type":"string","description":"Company slug, as returned by search_companies or company_history, e.g. vaz-metales-sl."},"limit":{"default":50,"title":"Limit","type":"integer","maximum":200,"description":"Maximum results per kind (trademarks, trading names), integer 1-200, e.g. 10 (default 50)."}},"required":["company"],"title":"company_brandsArguments"},"annotations":{"title":"A company's brands","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"8e398044570781662760df1fc20a60014dadda24128dea70fd01652d16e79195","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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: more than 580,000 NIF mappings from\npublic sources and the text of BORME notices cover a minority of companies.\nreason nif_unmapped: not matched yet, not proof of absence.\nreason nif_revoked: AEAT records a revocation; relay tell_the_user.\nOn a company match, relay nif_status.note if present.\ninvalid_input true: not a NIF/CIF.\nreason nif_check_character_failed: relay tell_the_user and did_you_mean.\nreason not_registry_entity: explain entity_type.\nambiguous true: ask which one. nif_caveat: say the link is not settled.\n\nRead-only. Basic plan+. API key: X-API-Key\n(https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"nif":{"title":"Nif","type":"string","description":"Spanish NIF/CIF, normally 9 characters, e.g. B12345674. Spaces, hyphens, dots and the ES VAT prefix (ESB12345674) are accepted; other country prefixes are not."}},"required":["nif"],"title":"company_by_nifArguments"},"annotations":{"title":"Find a company by NIF","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b50ab1ca7610dad6abec1c8b6c0db0d0689f1b0db788804b95b3cb639fad7fbd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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, published, awarded_on, buyer, title, lot, amount_eur,\ncpv, notice_url, minor}], sources}. Awards come from Spanish and EU public\nprocurement notices, matched by tax ID; awards published in multiple\nnotices are listed once. nif null means we hold no tax ID for the company,\nnot that it won nothing; count 0 is not proof it never won a contract.\nLegal-entity winners only; TED notices in the pre-eForms format\n(January-June 2024) are not included.\n\nRead-only; one request per call. Requires the Basic plan or higher and an\nAPI key in the X-API-Key header (https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"company":{"title":"Company","type":"string","description":"Company slug as returned by search_companies or company_history (e.g. vaz-metales-sl), or a name to search."},"date_from":{"title":"Date From","type":"string","description":"Optional earliest publication date, YYYY-MM-DD, e.g. 2024-01-01."},"date_to":{"title":"Date To","type":"string","description":"Optional latest publication date, YYYY-MM-DD, e.g. 2024-12-31."},"source":{"title":"Source","type":"string","description":"Optional, one or more of placsp, navarra, ted separated by commas, e.g. ted; omit for all."},"min_amount":{"title":"Min Amount","type":"number","description":"Optional minimum award amount in EUR, e.g. 100000."},"limit":{"default":50,"title":"Limit","type":"integer","maximum":200,"description":"Awards per page, integer 1-200, e.g. 20 (default 50)."},"offset":{"default":0,"title":"Offset","type":"integer","description":"Awards to skip, integer 0-10000 (default 0); pass the previous page's next_offset, e.g. 50."}},"required":["company"],"title":"company_contractsArguments"},"annotations":{"title":"A company's public contract awards","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"a1e0487657040e3c2ca2519416cdc5ecf4ee24bfb202f4aa4a99ed4ee8f8249b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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_eur, aid_equivalent_eur,\ncall {title, level, administration, body}}], note}. Only instrument\nsubsidy is a grant: a loan's amount_eur is the principal lent and a\nguarantee's the amount guaranteed, so never call them grants. Totals are\nper instrument; do not add nominal amounts across instruments. Awards\nbefore shown_from are no longer shown by BDNS. Quote attribution and\ndata_as_of with the data. An empty list means none is linked in our data,\nnot that none was received.\n\nRead-only. Needs the basic plan or higher: send your API key in the\nX-API-Key header (https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"company":{"title":"Company","type":"string","description":"Company slug, as returned by search_companies or company_history, e.g. vaz-metales-sl."},"instrument":{"title":"Instrument","items":{"type":"string"},"type":"array","description":"Optional list of aid instruments, each one of subsidy, loan, guarantee, tax_advantage, risk_finance, other, e.g. [\"subsidy\"]; omit for all."},"date_from":{"title":"Date From","type":"string","description":"Optional earliest award date, YYYY-MM-DD, e.g. 2024-01-01."},"date_to":{"title":"Date To","type":"string","description":"Optional latest award date, YYYY-MM-DD, e.g. 2025-12-31."},"limit":{"default":50,"title":"Limit","type":"integer","maximum":200,"description":"Awards per page, integer 1-200, e.g. 20 (default 50)."},"offset":{"default":0,"title":"Offset","type":"integer","description":"Awards to skip, integer 0-10000 (default 0); pass the previous page's next_offset, e.g. 50."}},"required":["company"],"title":"company_grantsArguments"},"annotations":{"title":"A company's public aid (BDNS)","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"cb720701bcfe9d7053c6300f2df2084d8af98739a80ed92ed154935cade03045","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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_slug, parents (nearest first), top_parent_slug,\nmembers: [{slug, name, province, status, owner_slug, depth, link_kind,\nsince, evidence: {event_id, date, text (excerpt, max 600 chars)}}],\nunresolved, truncated, note}. The highest member has owner_slug,\nlink_kind, since and evidence null. Names not matched to exactly one\ncompany appear as printed in unresolved; do not treat them as resolved\ncompanies. Max 200 members. include_directors adds director links, not\nmembers. Empty parents does not rule out control or a legal group.\n\nRead-only. Pro plan; X-API-Key header.","inputSchema":{"type":"object","properties":{"company":{"title":"Company","type":"string","description":"Company slug, e.g. vaz-metales-sl (from search_companies), or a name of at least 3 letters or digits, e.g. \"Mercadona\"."},"include_directors":{"default":false,"title":"Include Directors","type":"boolean","description":"Optional, one of true or false (default false), e.g. true to add legal persons appointed as directors of members and the companies a member administers, marked as director links; a director link alone does not make a company a member of the group."}},"required":["company"],"title":"company_groupArguments"},"annotations":{"title":"A company's identified sole-shareholder network","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"56779a66b95d9d3067b560219b53a06907cefdaa69073963bdfc804b15e2f6d0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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_seen, truncated,\nnext_offset, count, events} (as in search_events), with former_slugs for\na merged company (an old slug returns the merged timeline) and\nplan_window on a limited plan. total_events, first_seen and last_seen\ncover the whole timeline in your window, not this page. To page,\nkeep limit and order and pass next_offset as offset (at most 10000)\nuntil it is null.\n\nRead-only; one request per call. Without an API key (X-API-Key header) only\nthe last 7 days; basic covers 365 days, pro and risk the full history\nback to 2009. If all its events are outside your window, the refusal\ncounts them.","inputSchema":{"type":"object","properties":{"company":{"title":"Company","type":"string","description":"Company slug, e.g. vaz-metales-sl (from search_companies), or a name of at least 3 letters or digits, e.g. \"Mercadona\", searched case-insensitively."},"limit":{"default":100,"title":"Limit","type":"integer","maximum":200,"description":"Events per page, integer 1-200, e.g. 20 (default 100)."},"offset":{"default":0,"title":"Offset","type":"integer","description":"Events to skip, integer 0-10000 (default 0); pass the previous page's next_offset, e.g. 100."},"order":{"default":"desc","title":"Order","type":"string","description":"\"desc\" (default, newest first) or \"asc\" (oldest first), e.g. \"asc\" to start from the earliest event in your plan's window."},"include_inferred":{"title":"Include Inferred","type":"boolean","description":"Optional, default false, e.g. true. true allows an inferred sector on events without a CNAE code: the first act with a non-empty objeto social gets `fields` with `cnae_inferred` (a CNAE-2009 division), `cnae_source` `jev` and `cnae_inference` (`confidence`, `model`, `prompt`, `section`, `note`). Nothing is added if any act has a CNAE code, no act has a non-empty objeto social, or no decision qualifies. It is the output of a language model (TypeSafe Jev, model `typesafe-ai/jev-1.14.0`, prompt ID `two-stage-v1`), not a code published in BORME, and it describes the objeto social, not the company's verified activity. Only decisions whose confidence meets the threshold are returned (default 0.9). Inferred values are included only on request: if you omit `include_inferred` or set it to `false`, there are none. Only acts published from 2024-11-05 have inferred divisions (`note`), so more sector coverage from that date may reflect them and does not, by itself, show market growth."}},"required":["company"],"title":"company_historyArguments"},"annotations":{"title":"Company registry timeline","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"27673e99c465a02dc4db85495a408bfe140747e2faeafe9301db45553478b49e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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\nReturns JSON {company_slug, total, count, next_offset, signals:\n[{event_id, signal_type, date, company_slug, company_name, province,\ndetails}]}, with former_slugs for a merged company (every slug is read),\nand plan_window or hidden_by_plan when your plan's window applied: relay\ntheir notes. AEAT_DEBTOR: say the company was on the list published on\nthat date, never that the debt is outstanding. count 0 is not proof of\ngood health.\n\nRead-only; one request per call. Needs the pro plan or higher\n(CONSOLIDATION and PE_ENTRY: risk); key in the X-API-Key header\n(https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"company":{"title":"Company","type":"string","description":"Company slug, e.g. vaz-metales-sl (from search_companies), or a name of at least 3 letters or digits, e.g. \"Mercadona\", searched case-insensitively as in company_history."},"signal_types":{"title":"Signal Types","items":{"type":"string"},"type":"array","description":"Optional list; each one of INSOLVENCY_FILED, ACCORDION, MASS_EXIT, OWNERSHIP_CHANGE, DISTRESS_COMBO, PHOENIX, ADDRESS_CLUSTER, AEAT_DEBTOR, PUBLIC_CONTRACT_AWARD, and on the risk plan CONSOLIDATION and PE_ENTRY, e.g. [\"OWNERSHIP_CHANGE\", \"MASS_EXIT\"]; omit for all types your plan covers."},"date_from":{"title":"Date From","type":"string","description":"Earliest signal date, inclusive, YYYY-MM-DD, e.g. 2024-11-01. Optional; moved up to the start of your plan's window when earlier (plan_window says so)."},"date_to":{"title":"Date To","type":"string","description":"Latest signal date, inclusive, YYYY-MM-DD, e.g. 2026-10-31. Optional."},"limit":{"default":50,"title":"Limit","type":"integer","maximum":200,"description":"Signals per page, integer 1-200, e.g. 20 (default 50)."},"offset":{"default":0,"title":"Offset","type":"integer","description":"Signals to skip, integer 0-10000 (default 0); pass the previous page's next_offset, e.g. 50."}},"required":["company"],"title":"company_signalsArguments"},"annotations":{"title":"A company's signals","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"3518b49c8755df865326db82e2c301de1a4af23ffea6590d34145acee64a87ad","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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 with name, province and status};\nno match returns {error, suggested_companies}.\n\nReturns company_slug, current_name, nif, nif_caveat, sources and other card\nfields; former_slugs for a merged company. lei: GLEIF Legal Entity Identifier\nmatched by NIF; null means no match yet. website: from the newest BORME act\nabout the company website; null if none or removed. BORME does not report\nminority shareholdings, employee counts or revenue.\n\nRead-only; one request per call. Requires basic plan or higher; send your\nAPI key in X-API-Key (https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"company":{"title":"Company","type":"string","description":"Company slug, e.g. vaz-metales-sl (from search_companies), or a name of at least 3 letters or digits, e.g. \"Mercadona\", searched case-insensitively as in company_history."},"include_inferred":{"title":"Include Inferred","type":"boolean","description":"Optional, default false, e.g. true. true allows an inferred sector when the snapshot has no CNAE code: the newest eligible decision among the company's latest 500 events without a printed code fills `cnae` with a CNAE-2009 division, `cnae_version` `2009`, `cnae_source` `jev` and `cnae_inference` (`confidence`, `model`, `prompt`, `section`, `note`, `event_id`, `date`); with none eligible, none is added. It is the output of a language model (TypeSafe Jev, model `typesafe-ai/jev-1.14.0`, prompt ID `two-stage-v1`), not a code published in BORME, and it describes the objeto social, not the company's verified activity. Only decisions whose confidence meets the threshold are returned (default 0.9). Inferred values are included only on request: if you omit `include_inferred` or set it to `false`, there are none. Only acts published from 2024-11-05 have inferred divisions (`note`), so more sector coverage from that date may reflect them and does not, by itself, show market growth."}},"required":["company"],"title":"company_snapshotArguments"},"annotations":{"title":"Company registry card","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"540b1f8d5ee79a682ebb1b0e348f8c6a26af22bfa9f37b826e70f6d0f3dd1ebf","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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 with\nINSOLVENCY_DECLARATION or INSOLVENCY_STATUS (not SUSPENSION_OF_PAYMENTS,\nBANKRUPTCY_LEGACY or PROVISIONAL_SHEET_CLOSURE_INSOLVENCY). An\nINSOLVENCY_STATUS notice can record any stage, from a request for a\ndeclaration to the conclusion: before saying a company was declared\ninsolvent, read the act's payload with search_events. A day without a\ngazette (weekends, holidays) returns total_events 0.\n\nRead-only; one request per call. Without an API key only days within the\nlast 7 days; send your key in the X-API-Key header\n(https://bormeapi.com/account) for your plan's window.","inputSchema":{"type":"object","properties":{"date":{"title":"Date","type":"string","description":"Publication day, YYYY-MM-DD, e.g. 2026-10-27; omit for the latest day in the database."}},"title":"daily_digestArguments"},"annotations":{"title":"Daily BORME digest","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"14677b24cfa76af6233bd43ede28b41b099409e9c76547032f85e1018e0b3610","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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 company use company_history. A name is searched as in company_group.\n\nReturns JSON {company_slug, members, member_count, group_truncated,\ncount, offset, next_offset, events: [{event_id, date, borme_id, province,\ncompany_name, company_slug, member_slug, acts, registral}]}, with\nplan_window on a limited plan. member_slug is the group member the event\nbelongs to. To page, pass next_offset as offset until it is null.\n\nRead-only. Needs the pro plan (X-API-Key header).","inputSchema":{"type":"object","properties":{"company":{"title":"Company","type":"string","description":"Company slug, e.g. vaz-metales-sl, or a name of at least 3 letters or digits; its whole group is read."},"act_types":{"title":"Act Types","items":{"type":"string"},"type":"array","description":"Optional list of act type enums, e.g. [\"MERGER_BY_ABSORPTION\", \"SEGREGATION\"]. Full list: list_act_types."},"date_from":{"title":"Date From","type":"string","description":"Earliest publication date, inclusive, YYYY-MM-DD, e.g. 2025-01-01. Optional; moved up to your plan's window."},"date_to":{"title":"Date To","type":"string","description":"Latest publication date, inclusive, YYYY-MM-DD. Optional."},"limit":{"default":50,"title":"Limit","type":"integer","maximum":200,"description":"Events per page, integer 1-200, e.g. 20 (default 50)."},"offset":{"default":0,"title":"Offset","type":"integer","description":"Events to skip, integer 0-10000 (default 0); pass the previous page's next_offset."}},"required":["company"],"title":"group_historyArguments"},"annotations":{"title":"Registry events of the identified sole-shareholder network","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"005e412e5a94b687a0543ee7e9bb1f4985eb00857d666a7e945fe4d90ad0e9a0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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 against a quota. The same list is the resource\nborme://act-types.","inputSchema":{"type":"object","properties":{},"title":"list_act_typesArguments"},"annotations":{"title":"List act types","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"d4507147f95f78a90a6357ddbd9b8527131a5af66823186435c0ed48a8a8d971","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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}], full_feed}. AEAT_DEBTOR\ncomes from the AEAT's yearly debtors list (art. 95 bis LGT): details\ncarry listed_on, list_year, is_current_list (true for 12 months from\nlisted_on) and debt_eur, the published total at 31 December of the prior\nyear. Say the company was on the list published on that date; never say\nthe debt is still outstanding. count 0 means none in the window, not\nthat a company is risk-free; an unknown signal_type is refused with the\nvalid list.\n\nRead-only; one request per call. Needs the risk plan: send your API key in\nthe X-API-Key header (https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"signal_type":{"title":"Signal Type","type":"string","description":"Optional, one of INSOLVENCY_FILED, ACCORDION, MASS_EXIT, OWNERSHIP_CHANGE, DISTRESS_COMBO, PHOENIX, ADDRESS_CLUSTER, AEAT_DEBTOR, PUBLIC_CONTRACT_AWARD, CONSOLIDATION (a merger, segregation or global transfer), PE_ENTRY (a possible investment vehicle or manager, by name, becomes sole shareholder or director; re-elections are excluded, and a director appointment does not raise it if the entity already has an overlapping director or sole-shareholder link to that company), e.g. MASS_EXIT; omit for all types."}},"title":"recent_signalsArguments"},"annotations":{"title":"Recent risk signals","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5a65432cb9ec5d675e5f5fd20995f73f80e9d8a5e7635374909b08cf0b0c482e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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 hourly snapshot (planner estimates if no snapshot\nexists), the first and latest publication day held (YYYY-MM-DD), and the event-weighted parse\ncompleteness over the 30 days up to the latest run (e.g. 0.9987). Takes\nno arguments. Read-only, open to everyone, no key needed and not counted\nagainst a quota. The same report is the resource borme://coverage.","inputSchema":{"type":"object","properties":{},"title":"registry_statsArguments"},"annotations":{"title":"Data coverage and freshness","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"9633438e21d499ed152ce1485f529db1d3ddb40fb81fcec014fb2eb829c8ace7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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, offset, companies: [{company_slug,\nname, legal_form, province, municipality, status, in_insolvency,\nlast_act_date, match, matched_on}]}. match is exact, prefix, contains or\nfuzzy (a lead, not an identification; say so). Ranked by match, then\nactive companies, then newest act.\n\nRead-only; one request per call; not limited by the free plan's 7 days of\nhistory. The free plan shows at most the first 5 ranked cards;\nhidden_by_plan counts the rest: relay its note. The NIF is on the card\nfrom the basic plan up (X-API-Key header). An empty answer is not proof\nthat a business does not exist.","inputSchema":{"type":"object","properties":{"name":{"title":"Name","type":"string","description":"The bare company name or part of it, at least 3 letters or digits and at most 200 characters, e.g. \"inditex\" or \"Talleres Jarama\": no city, parentheses or notes. Matching allows for case, accents and punctuation, and a legal form such as SL or SA can be left out. Do not repeat the same query unchanged after an empty answer: read note and hidden_by_plan if present."},"province":{"title":"Province","type":"string","description":"Optional province, accent-insensitive, e.g. MADRID or VIZCAYA, or an autonomous community for all of its provinces, e.g. Catalonia; several values separated by commas, e.g. BIZKAIA,GIPUZKOA. Applied to the candidates the search reads (2,000 with a filter), so a broad name can return fewer companies than match it."},"status":{"title":"Status","type":"string","description":"Optional, one of active, dissolved, extinct, sheet_closed, e.g. active; applied like province."},"limit":{"default":10,"title":"Limit","type":"integer","maximum":50,"description":"Cards per page, integer 1-50, e.g. 5 (default 10)."},"offset":{"default":0,"title":"Offset","type":"integer","description":"Cards to skip, integer 0-200 (default 0), e.g. 10. At most 200 cards are ranked; truncated true means a candidate cap was reached or a search step ran out of time, so add another word from the name."}},"required":["name"],"title":"search_companiesArguments"},"annotations":{"title":"Search companies by name","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0453d8309b2857226a2037bdb6115339a4431ee4ce57050e6395a97f9500977e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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.\n\nUse it for questions about many companies (\"insolvency notices in Valencia\nin September\"). 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, company_slug, acts: [{act_type, act_type_raw, roles,\npayload}], registral}]}, plus company_name_match, plan_window and\nhidden_by_plan when they apply. No next page: when count equals limit,\nnarrow the filters.\n\nRead-only; one request per call against your daily quota. Without an API key\n(X-API-Key header, https://bormeapi.com/account) only the last 7 days\nare searched (plan_window). For an empty page with hidden_by_plan or\ncompany_name_match (matched_companies or suggested_companies), relay its\nnote. Invalid dates, provinces or act types are refused with a reason.","inputSchema":{"type":"object","properties":{"date_from":{"title":"Date From","type":"string","description":"Earliest publication date, inclusive, YYYY-MM-DD, e.g. 2026-09-01. Optional; data starts on 2009-01-02. Without a key it is moved up to 7 days ago (plan_window says so)."},"date_to":{"title":"Date To","type":"string","description":"Latest publication date, inclusive, YYYY-MM-DD, e.g. 2026-09-30. Optional; defaults to the latest day held."},"provinces":{"title":"Provinces","items":{"type":"string"},"type":"array","description":"Optional list of BORME province names, accent- and case-insensitive, e.g. [\"MADRID\", \"CADIZ\", \"VIZCAYA\"]. An autonomous community stands for all of its provinces, e.g. [\"Basque Country\"] or [\"Cataluña\"]. Full list: the resource borme://provinces."},"act_types":{"title":"Act Types","items":{"type":"string"},"type":"array","description":"Optional list of act type enums; an event matches if it has any of them, e.g. [\"INCORPORATION\"] or [\"INSOLVENCY_DECLARATION\", \"INSOLVENCY_STATUS\"]. Full list: list_act_types. Barcelona prints some acts as free text under \"Otros conceptos\": recognised wording is mapped to a normalised act type, while act_type_raw remains \"Otros conceptos\". The payload retains the source text, including any sole shareholder's name. When a revocation and a new appointment appear in the same entry, the API maps the combination to RE_ELECTIONS; this is an API classification and does not establish that the source describes a re-election. Reprocessed events keep their event_id, but their acts can change."},"company_name_contains":{"title":"Company Name Contains","type":"string","description":"Optional part of the company name, case- and accent-insensitive, e.g. \"mercadona\"; use at least 3 letters or digits for a selective search. % and _ match literally. It filters events; to look a company up by name, call search_companies first."},"limit":{"default":50,"title":"Limit","type":"integer","maximum":200,"description":"Maximum events returned, integer 1-200, e.g. 20 (default 50)."},"holder_kind":{"title":"Holder Kind","type":"string","description":"Optional, one of investment_vehicle or investment_manager, e.g. investment_vehicle. Returns events that originate a sole-shareholder or legal-person director link classified, from the entity's name alone, as investment_vehicle (a possible investment vehicle: SCR, ECR, FCR, FCRE, SICAV, capital riesgo, private equity, fondo de inversión) or investment_manager (a possible investment manager: SGEIC, SGIIC). It does not return every subsequent act mentioning that entity. A director link may originate in a re-election act. The name alone does not establish registration with the CNMV. This filter does not identify entities whose names contain none of these indicators. date_from and date_to may be at most 366 days apart; both dates are included, so at most 367 calendar days. Without date_from, the range covers 90 calendar days ending on date_to or today, including that day. Pro plan."}},"title":"search_eventsArguments"},"annotations":{"title":"Search registry events","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b817d3006f9ecb2bb45651d59e03e0782edda92bd2c61c526f75f086f818f9a2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"},{"serverName":"com.bormeapi/borme-mcp","endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","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, country_code, number, valid, request_date, source,\nnote}. Relay note as given: the check does not identify the holder, and a\nnegative result says nothing about the domestic tax identifier.\ninvalid_input true: relay tell_the_user. error vies_unavailable or\nvat_check_rate_limited: the check could not be made now; do not call the\nnumber valid or invalid.\n\nRead-only. Needs the basic plan or higher: send your API key in the\nX-API-Key header (https://bormeapi.com/account).","inputSchema":{"type":"object","properties":{"vat_number":{"title":"Vat Number","type":"string","description":"EU VAT number with its two-letter country code, e.g. ESA28015865 or DE123456789. Spaces, dots and hyphens are ignored; GR is read as EL; a Spanish NIF without a prefix is checked as ES."}},"required":["vat_number"],"title":"vat_checkArguments"},"annotations":{"title":"Check an EU VAT number in VIES","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"21fcbc40e9771dc01ffa849bb95352ec187b280af8f7c8aa8e0b89db0d7ac34e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T16:46:26.673Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"f9b9c2db7b2f7224ea9f4ad0b4621b7ab979cf1f803f664c64c49923812f1d6d","protocol":"streamable-http","status":"auth-required","toolCount":0,"observedAt":"2026-10-30T03:46:28.370Z"},{"endpointFingerprint":"231fa14113f3ebbc0ba279d0af3d1f4f6291bb0171a5d33e103186a2c975098c","protocol":"streamable-http","status":"indexed","toolCount":18,"observedAt":"2026-11-16T16:46:26.673Z"}],"authentication":"required"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.bormeapi/borme-mcp":{"url":"https://mcp.bormeapi.com/mcp"}}},"Cursor":{"mcpServers":{"com.bormeapi/borme-mcp":{"url":"https://mcp.bormeapi.com/mcp"}}},"VS Code":{"servers":{"com.bormeapi/borme-mcp":{"type":"http","url":"https://mcp.bormeapi.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.bormeapi.com/mcp"},{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.bormeapi.com/mcp/oauth"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.bormeapi%2Fborme-mcp","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.bormeapi%2Fborme-mcp","name":"com.bormeapi/borme-mcp","description":"Spain's company registry gazette (BORME): more than 9.6 million events since 2009. API key or OAuth.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.bormeapi.com/mcp"},{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.bormeapi.com/mcp/oauth"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://bormeapi.com/mcp","repositoryUrl":"https://github.com/bormeapi/borme-mcp","version":"2.1.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.bormeapi/borme-mcp","status":"online","lastCheckedAt":"2026-11-20T05:17:17.564Z","lastSuccessfulCheck":"2026-11-20T05:17:17.564Z","latencyMs":354,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T05:17:17.564Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T05:17:17.564Z"},"security":null,"timestamps":{"createdAt":"2026-10-30T02:13:39.418Z","updatedAt":"2026-10-30T02:13:39.418Z","observedAt":"2026-11-20T05:17:17.564Z"},"compatibility":{"serverVersion":"2.1.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}