io.github.odela-pixel/asientouno

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 <api_key>
• 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

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:

{
  "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

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.