BORME API

BORME API for AI assistants (MCP)

Connect Microsoft Copilot, Claude, Cursor or any MCP client to Spanish company registry data published in the BORME: notices since 2009, company histories, company search by name, NIF lookup, trademarks and trading names, and risk signals.

How it works · What each plan includes · Microsoft Copilot Studio · Claude · Claude Code · Cursor · Other clients · Tools · Example questions · Limits and fair use

How it works

Get an API key Pricing · REST API docs

What each plan includes

The MCP server uses the same key and the same daily quota as the REST API.

Microsoft Copilot Studio and Microsoft 365 Copilot

These steps follow Microsoft's documentation. They may vary with your tenant and your data loss prevention (DLP) policies.

  1. In Copilot Studio, open the agent you want to use and go to Tools > Add a tool > New tool > Model Context Protocol.
  2. Enter a Server name (BORME API), a Server description and the Server URL: https://mcp.bormeapi.com/mcp
  3. For authentication, choose API key, set Type to Header and enter X-API-Key as the header name. Select Create, then Create a new connection, enter your key and select Add to agent.
  4. Test the agent in Copilot Studio first. Then publish it and set up the Teams and Microsoft 365 Copilot channel, subject to your organization's permissions and policies. If your organization has Power Platform data policies (DLP), an administrator may need to allow this connector.
  5. Try a question such as: "Which board appointments and terminations of Telefónica, S.A. appear in the published notices, and on which dates?"

Claude (claude.ai and Claude Desktop)

Go to Customize > Connectors > Add custom connector and enter the server URL. Choose No sign-in and add the x-api-key header with your key under Request headers. Anthropic offers request headers as a beta to a limited set of organizations; if you do not see that section, use the Claude Desktop alternative below. On Team and Enterprise plans an owner adds the connector under Organization settings.

Claude Desktop alternative: add the server to claude_desktop_config.json through mcp-remote, a third-party bridge that needs Node.js:

{
  "mcpServers": {
    "borme": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.bormeapi.com/mcp",
               "--header", "X-API-Key:${BORME_API_KEY}"],
      "env": { "BORME_API_KEY": "YOUR_KEY" }
    }
  }
}

Claude Code

claude mcp add --transport http --scope user \
  --header "X-API-Key: YOUR_KEY" \
  borme https://mcp.bormeapi.com/mcp

--scope user makes the server available in all your projects; leave it out to add it to the current project only.

Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) and set BORME_API_KEY in your environment:

{
  "mcpServers": {
    "borme": {
      "url": "https://mcp.bormeapi.com/mcp",
      "headers": { "X-API-Key": "${env:BORME_API_KEY}" }
    }
  }
}

Any other Streamable HTTP client

Send each JSON-RPC message as a POST to https://mcp.bormeapi.com/mcp with Content-Type: application/json, an Accept header that includes application/json, and your key in X-API-Key. For example, to list the tools:

curl -s https://mcp.bormeapi.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ChatGPT: its custom connectors cannot send an API-key header, so ChatGPT can use this server only without a key, on the free plan.

Tools

search_companies
Find companies by current or former name and get ranked company cards.
company_history
The registry timeline of one company: the published acts available under your plan, newest first.
search_events
Search BORME notices by date, province, act type and company name.
daily_digest
One publication day in figures, with its insolvency notices.
company_by_nif
Find a company by its NIF/CIF tax ID (basic plan and above).
brand_owner
Find the company a trademark or trading name is linked to (basic plan and above).
company_brands
Trademarks and trading names linked to one company (basic plan and above).
recent_signals
The latest risk signals, such as insolvency filings and mass exits (risk plan).
list_act_types
The act types, with their English labels and the original Spanish headings.
registry_stats
Size and coverage of the registry data.

Example questions

Answers from the live server on 27 October 2026, shortened.

  1. "Find Inditex." search_companies: 7 matches; first INDITEX, S.A. (exact match, active, A Coruña), then INDITEX LOGISTICA, S.A. and INDITEX RENOVABLES, S.L.
  2. "Which company has NIF A28015865?" company_by_nif: TELEFONICA SA., active, Madrid.
  3. "Show Telefónica's appointments, terminations and revocations." company_history: 364 published events from 5 February 2009 to 6 August 2026; the latest, on 6 August 2026, revokes and appoints proxy holders.
  4. "How many insolvency notices were published in Valencia in September 2026?" search_events: 36, from 4 to 30 September.
  5. "Who owns the trading name ZARA?" brand_owner: the trading name ZARA is linked to ZARA ESPAÑA, S.A. (a name match, not confirmed ownership).
  6. "What risk signals were published today?" recent_signals: 10 on 27 October 2026: 5 mass exits, 3 accordion operations (a capital reduction and increase), 2 public contract awards.
  7. "Summarize today's BORME." daily_digest: 27 October 2026: 557 incorporations, 1,667 appointment acts, 36 insolvency notices; Madrid leads with 756 events.
  8. "How much data is there?" registry_stats: about 9.65 million events and 3.41 million companies, from 2 January 2009.

Limits and fair use

Questions about an integration or a pilot? Write to us; we answer personally, usually the same working day.

build 2026.10.27·6fd584ac