← The evidence ledger
Evidence row 1248813
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint 865ea385-b9f0-4dc8-8a36-482766e78649
- Recorded
- Previous row
- None: the first of its kind about this subject
- Body SHA-256
- f405db5146d8beb2322e96c1489edc2cadfd625aed01104c1b23e6c53be990b8
- Leaf
- 0xa4e7efd63fc180e282ab21457788a28ef8f95d353d776d44287004b055e24424
What was observed
{
"count": 10,
"tools": [
{
"description": "Find the Spanish company a trademark or trading name is linked to, in the\nSpanish patent office's (OEPM) trademark and commercial-name records we\nhold (the archive starts in 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}. kind\ncommercial_name identifies a business; trademark distinguishes goods or\nservices (NESCAFÉ is not another name for Nestlé): say which kind a hit\nis. Links come from holder-name matching (the office publishes no tax\nIDs); ambiguous holders stay unlinked: present a hit as a name match,\nnot confirmed ownership. found false is not proof the brand is unused.\nOn a hit, use company_history with 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": {
"properties": {
"brand": {
"description": "Brand or trading name, or part of it, at least 3 letters or digits after punctuation is removed, case-insensitive, e.g. \"ZARA\".",
"title": "Brand",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum matches, integer 1-200, e.g. 10 (default 20).",
"title": "Limit",
"type": "integer"
}
},
"required": [
"brand"
],
"title": "brand_ownerArguments",
"type": "object"
},
"name": "brand_owner"
},
{
"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 for a known company (a slug from search_companies or\ncompany_history); to go from a brand 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}. The\noffice publishes no tax IDs, so every link is a name match, not\nconfirmed ownership. An empty result means none is linked in our data,\nnot that the company holds none. limit applies to each kind separately,\nnewest first; counts is what this answer lists, not the company's total,\nand truncated true for a kind means 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": {
"properties": {
"company": {
"description": "Company slug, as returned by search_companies or company_history, e.g. vaz-metales-sl.",
"title": "Company",
"type": "string"
},
"limit": {
"default": 50,
"description": "Maximum results per kind (trademarks, trading names), integer 1-200, e.g. 10 (default 50).",
"title": "Limit",
"type": "integer"
}
},
"required": [
"company"
],
"title": "company_brandsArguments",
"type": "object"
},
"name": "company_brands"
},
{
"description": "Look up a Spanish company by its NIF/CIF tax ID. Use it when the user gives\na tax ID (with a name use search_companies); on a hit, call\ncompany_history with the company_slug.\n\nReturns JSON {found, company_slug, company_name, current_name, status,\nprovince, nif_source, nif_caveat, ...}; use current_name. BORME has no\ndedicated tax-ID field: there are more than 580,000 NIF mappings from\npublic sources and the text of BORME notices, covering a minority of\ncompanies, so a miss (reason nif_unmapped) means \"not matched yet\", not\n\"does not exist\". invalid_input true: not a NIF/CIF. reason\nnif_check_character_failed: wrong check character; relay tell_the_user\nand the did_you_mean candidates. reason not_registry_entity: explain\nentity_type as the note does. ambiguous true: ask which candidate.\nnif_caveat present: say the link is not settled.\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": {
"properties": {
"nif": {
"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.",
"title": "Nif",
"type": "string"
}
},
"required": [
"nif"
],
"title": "company_by_nifArguments",
"type": "object"
},
"name": "company_by_nif"
},
{
"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 instead\nof a slug is searched: several matches return {ambiguous: true,\ncandidates}, none returns {error}.\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 just 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": {
"properties": {
"company": {
"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.",
"title": "Company",
"type": "string"
},
"limit": {
"default": 100,
"description": "Events per page, integer 1-200, e.g. 20 (default 100).",
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Events to skip, integer 0-10000 (default 0); pass the previous page's next_offset, e.g. 100.",
"title": "Offset",
"type": "integer"
},
"order": {
"default": "desc",
"description": "\"desc\" (default, newest first) or \"asc\" (oldest first), e.g. \"asc\" to start from the earliest event in your plan's window.",
"title": "Order",
"type": "string"
}
},
"required": [
"company"
],
"title": "company_historyArguments",
"type": "object"
},
"name": "company_history"
},
{
"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": {
"properties": {
"date": {
"description": "Publication day, YYYY-MM-DD, e.g. 2026-10-27; omit for the latest day in the database.",
"title": "Date",
"type": "string"
}
},
"title": "daily_digestArguments",
"type": "object"
},
"name": "daily_digest"
},
{
"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": {
"properties": {},
"title": "list_act_typesArguments",
"type": "object"
},
"name": "list_act_types"
},
{
"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": {
"properties": {
"signal_type": {
"description": "Optional, one of INSOLVENCY_FILED, ACCORDION, MASS_EXIT, OWNERSHIP_CHANGE, DISTRESS_COMBO, PHOENIX, ADDRESS_CLUSTER, AEAT_DEBTOR, PUBLIC_CONTRACT_AWARD, e.g. MASS_EXIT; omit for all types.",
"title": "Signal Type",
"type": "string"
}
},
"title": "recent_signalsArguments",
"type": "object"
},
"name": "recent_signals"
},
{
"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}: approximate event and company\ncounts (planner estimates, not exact tallies), the first and latest\npublication 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": {
"properties": {},
"title": "registry_statsArguments",
"type": "object"
},
"name": "registry_stats"
},
{
"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": {
"properties": {
"limit": {
"default": 10,
"description": "Cards per page, integer 1-50, e.g. 5 (default 10).",
"title": "Limit",
"type": "integer"
},
"name": {
"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.",
"title": "Name",
"type": "string"
},
"offset": {
"default": 0,
"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.",
"title": "Offset",
"type": "integer"
},
"province": {
"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.",
"title": "Province",
"type": "string"
},
"status": {
"description": "Optional, one of active, dissolved, extinct, sheet_closed, e.g. active; applied like province.",
"title": "Status",
"type": "string"
}
},
"required": [
"name"
],
"title": "search_companiesArguments",
"type": "object"
},
"name": "search_companies"
},
{
"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). An empty page with hidden_by_plan means\nmatches exist outside your plan's window: do not say none exist. A bad\ndate, province or act type is refused with a message naming the fix.",
"inputSchema": {
"properties": {
"act_types": {
"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 gets its own act type (act_type_raw stays \"Otros conceptos\"; fields.shareholder names a sole shareholder when the text does), and a same-entry revocation and reappointment becomes RE_ELECTIONS. Reprocessed events keep their event_id, but their acts can change.",
"items": {
"type": "string"
},
"title": "Act Types",
"type": "array"
},
"company_name_contains": {
"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.",
"title": "Company Name Contains",
"type": "string"
},
"date_from": {
"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).",
"title": "Date From",
"type": "string"
},
"date_to": {
"description": "Latest publication date, inclusive, YYYY-MM-DD, e.g. 2026-09-30. Optional; defaults to the latest day held.",
"title": "Date To",
"type": "string"
},
"limit": {
"default": 50,
"description": "Maximum events returned, integer 1-200, e.g. 20 (default 50).",
"title": "Limit",
"type": "integer"
},
"provinces": {
"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.",
"items": {
"type": "string"
},
"title": "Provinces",
"type": "array"
}
},
"title": "search_eventsArguments",
"type": "object"
},
"name": "search_events"
}
]
}What the leaf hashes
{"body":"f405db5146d8beb2322e96c1489edc2cadfd625aed01104c1b23e6c53be990b8","id":1248813,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793365701895431,"prev":null,"subject":"865ea385-b9f0-4dc8-8a36-482766e78649","subject_kind":"endpoint"}Proof
Its day has not closed yet. A day closes ten minutes after midnight UTC; the proof appears here then.