BORME API

BORME API para asistentes de IA (MCP)

Conecte Microsoft Copilot, Claude, Cursor o cualquier cliente MCP a los datos del Registro Mercantil publicados en el BORME: anuncios desde 2009, historial de sociedades, búsqueda de sociedades por nombre, búsqueda por NIF, marcas y nombres comerciales, y señales de riesgo.

Cómo funciona · Qué incluye cada plan · Microsoft Copilot Studio · Claude · Claude Code · Cursor · Otros clientes · Herramientas · Preguntas de ejemplo · Límites y uso razonable

Cómo funciona

Obtener una clave de API Precios · Documentación de la API REST

Qué incluye cada plan

El servidor MCP utiliza la misma clave y la misma cuota diaria que la API REST.

Microsoft Copilot Studio y Microsoft 365 Copilot

Estos pasos siguen la documentación de Microsoft. Pueden variar según su inquilino (tenant) y sus directivas de prevención de pérdida de datos (DLP).

  1. En Copilot Studio, abra el agente que vaya a usar y vaya a Herramientas > Agregar una herramienta > Nueva herramienta > Protocolo de contexto de modelo.
  2. Indique el nombre del servidor (BORME API), una descripción y la URL del servidor: https://mcp.bormeapi.com/mcp
  3. En el tipo de autenticación, seleccione Clave de API > Encabezado e indique X-API-Key como nombre. Pulse Crear; después, Crear una nueva conexión, introduzca su clave y seleccione Agregar al agente.
  4. Pruebe primero el agente en Copilot Studio. Después, publíquelo y configure el canal Teams y Microsoft 365 Copilot, sujeto a los permisos y directivas de su organización. Si su organización tiene directivas de datos (DLP) en Power Platform, puede que un administrador tenga que permitir este conector.
  5. Pruebe con una pregunta como: «¿Qué nombramientos y ceses de administradores de Telefónica, S.A. constan en los anuncios publicados y en qué fechas?»

Claude (claude.ai y Claude Desktop)

Vaya a Customize > Connectors > Add custom connector e indique la URL del servidor. Elija No sign-in y añada la cabecera x-api-key con su clave en Request headers. Anthropic ofrece las cabeceras de petición en beta a un número limitado de organizaciones; si no ve esa sección, use la alternativa para Claude Desktop que figura más abajo. En los planes Team y Enterprise, un propietario añade el conector en Organization settings.

Alternativa para Claude Desktop: añada el servidor a claude_desktop_config.json mediante mcp-remote, un puente de terceros que necesita 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": "SU_CLAVE" }
    }
  }
}

Claude Code

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

--scope user deja el servidor disponible en todos sus proyectos; sin esa opción, se añade solo al proyecto actual.

Cursor

Añada esto a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un proyecto) y defina BORME_API_KEY en su entorno:

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

Cualquier otro cliente Streamable HTTP

Envíe cada mensaje JSON-RPC con POST a https://mcp.bormeapi.com/mcp, con Content-Type: application/json, una cabecera Accept que incluya application/json y su clave en X-API-Key. Por ejemplo, para obtener la lista de herramientas:

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

ChatGPT: sus conectores personalizados no pueden enviar una cabecera con la clave de API, por lo que ChatGPT solo puede usar este servidor sin clave, con el plan gratuito.

Herramientas

search_companies
Busca sociedades por denominación actual o anterior y devuelve fichas ordenadas.
company_history
La cronología registral de una sociedad: los actos publicados disponibles en su plan, del más reciente al más antiguo.
search_events
Busca anuncios del BORME por fecha, provincia, tipo de acto y denominación.
daily_digest
Un día de publicación en cifras, con sus anuncios concursales.
company_by_nif
Busca una sociedad por su NIF/CIF (plan basic o superior).
brand_owner
Busca la sociedad a la que está vinculada una marca o un nombre comercial (plan basic o superior).
company_brands
Marcas y nombres comerciales vinculados a una sociedad (plan basic o superior).
recent_signals
Las señales de riesgo más recientes, como solicitudes de concurso o salidas masivas (plan risk).
list_act_types
Los tipos de acto, con su etiqueta en inglés y el epígrafe original en español.
registry_stats
Tamaño y cobertura de los datos del registro.

Preguntas de ejemplo

Respuestas del servidor en producción del 27 de octubre de 2026, resumidas.

  1. «Busca Inditex.» search_companies: 7 coincidencias; la primera, INDITEX, S.A. (coincidencia exacta, activa, A Coruña), y después INDITEX LOGISTICA, S.A. e INDITEX RENOVABLES, S.L.
  2. «¿Qué sociedad tiene el NIF A28015865?» company_by_nif: TELEFONICA SA., activa, Madrid.
  3. «Muestra los nombramientos, ceses y revocaciones de Telefónica.» company_history: 364 eventos publicados entre el 5 de febrero de 2009 y el 6 de agosto de 2026; el más reciente, del 6 de agosto de 2026, revoca y nombra apoderados.
  4. «¿Cuántos anuncios concursales se publicaron en Valencia en septiembre de 2026?» search_events: 36, entre el 4 y el 30 de septiembre.
  5. «¿De quién es el nombre comercial ZARA?» brand_owner: el nombre comercial ZARA está vinculado a ZARA ESPAÑA, S.A. (una coincidencia de nombre, no una titularidad confirmada).
  6. «¿Qué señales de riesgo se han publicado hoy?» recent_signals: 10 el 27 de octubre de 2026: 5 salidas masivas, 3 operaciones acordeón (reducción y ampliación de capital) y 2 adjudicaciones de contratos públicos.
  7. «Resume el BORME de hoy.» daily_digest: 27 de octubre de 2026: 557 constituciones, 1.667 actos de nombramiento y 36 anuncios concursales; Madrid encabeza la lista con 756 eventos.
  8. «¿Cuántos datos hay?» registry_stats: unos 9,65 millones de eventos y 3,41 millones de sociedades, desde el 2 de enero de 2009.

Límites y uso razonable

¿Preguntas sobre una integración o una prueba piloto? Escríbanos; respondemos personalmente, normalmente el mismo día hábil.

build 2026.10.27·6fd584ac