README

BORME MCP Server

MCP server for Spain's official company registry (BORME — Boletín Oficial del Registro Mercantil): 9.5M+ typed company events since 2009, updated every business day. Incorporations, director appointments, insolvencies, capital changes — 52 event kinds as English enums.

Hosted endpoint (no setup)

{
  "mcpServers": {
    "borme": {
      "url": "https://mcp.bormeapi.com/mcp"
    }
  }
}

Free, read-only, capped at 50 rows per query. Backed by the full 17-year corpus.

Tools

Tool	What it does
`search_events`	Filter events by date range, province, act type, company name
`company_history`	Full timeline of one company (fuzzy name match)
`daily_digest`	One day's registry activity, aggregated
`registry_stats`	Corpus coverage and volume stats
`list_act_types`	The 52-enum vocabulary with Spanish originals

Example prompts

"Which companies declared insolvency in Valencia last week?"
"Show the corporate history of Telefónica Audiovisual Digital"
"How many new companies were incorporated in Madrid in June?"

Self-hosting

server.py is the complete server (FastMCP + psycopg). It expects a Postgres with the BORME schema and a read-only role:

BORME_DSN=postgresql://user:pass@host/borme \
BORME_MCP_TRANSPORT=streamable-http \
python server.py

Building the dataset yourself: see our engineering notes — You don't need to scrape BORME.

REST API with webhooks & watchlists: bormeapi.com
Apify actor (pay-per-event feed): Spain Company Registry — BORME Events

License

MIT (server code). The underlying data originates from boe.es open data (public sector information, Ley 37/2007).

BORME MCP Server

README

BORME MCP Server

Hosted endpoint (no setup)

Tools

Example prompts

Self-hosting

Related

License

Recommended Servers