# 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

| 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.