# Asiento Uno — servidor MCP del Registro Mercantil español Datos del **BORME** (Boletín Oficial del Registro Mercantil) cruzados con **subvenciones públicas (BDNS)** y **contratos públicos (PLACSP)**, por empresa, con enlace al documento oficial de cada dato. Pensado para agentes de IA: diligencia debida, KYB, verificación de proveedores y clientes. - Endpoint remoto: `https://mcp.asientouno.com/mcp` (Streamable HTTP, JSON-RPC) - Autenticación: `Authorization: Bearer ` - Plan gratuito: 50 llamadas al día (Pro: 500, Business: 5.000), 60 por minuto - Web: https://asientouno.com/mcp · Precios: https://asientouno.com/precios > **English**: MCP server for the Spanish Companies Registry gazette (BORME), > joined with public grants (BDNS) and public procurement awards (PLACSP) per > company. Every fact links to its official publication. Remote Streamable > HTTP endpoint, Bearer API key, free tier (50 calls/day), self-serve signup. ## Herramientas | Herramienta | Qué devuelve | |---|---| | `asientouno_buscar_empresa` | Nombre o NIF → empresas coincidentes (con desambiguación: dice cuándo no está segura). | | `asientouno_informe_completo` | Identificativos, órgano de administración vigente, actos recientes y señales de riesgo (concurso, disolución, extinción). | | `asientouno_actos_borme` | Actos societarios paginados por cursor, cada uno con la URL oficial de su publicación en el BORME. | | `asientouno_cargos_persona` | Nombre de persona → cargos vigentes e históricos y empresas vinculadas (el grafo de relaciones). | | `asientouno_subvenciones_empresa` | Subvenciones registradas en la BDNS para la empresa. | | `asientouno_contratos_empresa` | Adjudicaciones en la PLACSP para la empresa. | | `asientouno_riesgo_empresa` | Concurso, disolución y extinción publicados en el BORME, con fecha y documento. | | `asientouno_cuentas_anuales` | Responde `no_disponible_aun` cuando no hay dato: nunca inventa una cifra. | Todas las herramientas son de solo lectura (`readOnlyHint: true`). ## Conseguir una API key En https://asientouno.com/cuenta: entras con tu correo (enlace mágico, sin contraseña) y pulsas «Crear mi API key gratuita». La clave aparece en pantalla una sola vez. Sin tarjeta. Los planes Pro y Business se contratan en https://asientouno.com/precios y suben la cuota de esa misma clave. ## Conectar ### Claude Desktop / Claude Code (vía `mcp-remote`) `examples/claude_desktop_config.json`: ```json { "mcpServers": { "asientouno": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.asientouno.com/mcp", "--header", "Authorization: Bearer ${ASIENTOUNO_API_KEY}" ], "env": { "ASIENTOUNO_API_KEY": "tu_api_key" } } } } ``` ### Cualquier cliente MCP con transporte HTTP ```bash curl -s https://mcp.asientouno.com/mcp \ -H "Authorization: Bearer $ASIENTOUNO_API_KEY" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' ``` Sin clave, el servidor responde `401` con el mensaje exacto de lo que falta. `https://mcp.asientouno.com/health` es público y devuelve `{"estado":"ok"}`. ## Cifras (26/09/2026) - 883.659 sociedades y 3,9 millones de actos del BORME (boletines desde el 11/03/2024). - 148.339 concesiones de la BDNS (desde 2022), 66.546 atribuidas a 24.051 sociedades. - 653.078 adjudicaciones de la PLACSP (desde 2004). ## Lo que este servidor NO hace - No da cuentas anuales ni cifras de facturación: `asientouno_cuentas_anuales` responde `no_disponible_aun`. - No dice si una empresa está sancionada: una coincidencia por nombre con una lista no es una sanción. - No cubre el BORME anterior a marzo de 2024 ni empresas fuera de España. - No tiene SLA: es un servicio en un servidor único; `/health` es público para que lo vigiles. - El saludo del protocolo (`initialize`, `tools/list`) responde sin clave; los datos (`tools/call`) no. ## Fuentes y límites, dichos claros - BORME cargado desde marzo de 2024; BDNS desde 2022; PLACSP desde 2004. - Una coincidencia por nombre no es una identificación: la búsqueda devuelve candidatos y `siguiente_paso` cuando hay ambigüedad. - Nunca se afirma que una empresa esté sancionada por una coincidencia de nombre. - Plan gratuito: los nombres de personas físicas van parcialmente ocultos (en los campos y en el texto de los actos) y `asientouno_cargos_persona` solo busca sociedades. Pro y Business los muestran completos. El nombre de una sociedad es público y se ve siempre. ## Licencia Este repositorio (documentación y ejemplos) es MIT. Los datos que sirve el endpoint proceden de fuentes públicas (BOE, IGAE, Ministerio de Hacienda) y se reutilizan conforme a la Ley 37/2007; cada respuesta enlaza a su publicación.