io.github.odela-pixel/asientouno

Official8 tools

by odela-pixel

Registro Mercantil español (BORME) + subvenciones (BDNS) + contratos públicos (PLACSP), por empresa.

MCP Server: io.github.odela-pixel/asientouno

This MCP server provides access to Spanish business registries by company, combining Registro Mercantil español (BORME), subvenciones via BDNS, and public contracts via PLACSP. The server is organized around per-company data, based on its description and catalog entry.

🛠️ Key Features

Company-level coverage
Registro Mercantil español (BORME)
Subvenciones (BDNS)
Contratos públicos (PLACSP)

🚀 Use Cases

Look up information for a specific company across BORME, BDNS, and PLACSP
Consolidate references from multiple Spanish public sources by company

⚡ Developer Benefits

Structured, per-company dataset scope
Data sourcing spans BORME, BDNS, and PLACSP

⚠️ Limitations

No additional capabilities (e.g., tools, endpoints, parameters) are described in the provided source data.

Topics

bormekybmcpmodel-context-protocolopen-dataregistro-mercantilspain

Captured live from the server via tools/list.

asientouno_buscar_empresa

Busca empresas por nombre o NIF en el registro mercantil español (datos reales del BORME).

Parameters2

query	string	required	Nombre (parcial) o NIF de la empresa
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Nombre (parcial) o NIF de la empresa"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

asientouno_informe_completo

Informe completo de una empresa: datos identificativos, órgano de administración vigente, actos recientes y señales (concurso, disolución).

Parameters1

empresa_id

integer

required

id devuelto por asientouno_buscar_empresa (el NIF no siempre está disponible en datos BORME)

Raw schema

{
  "type": "object",
  "properties": {
    "empresa_id": {
      "type": "integer",
      "description": "id devuelto por asientouno_buscar_empresa (el NIF no siempre está disponible en datos BORME)"
    }
  },
  "required": [
    "empresa_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

asientouno_actos_borme

Lista los actos del BORME de una empresa, paginados, con enlace al PDF oficial de cada uno (provenance).

Parameters5

empresa_id	integer	required
desde	string	optional	Fecha ISO (YYYY-MM-DD); solo actos publicados desde entonces
tipo	string	optional	Filtra por tipo de concepto (p.ej. 'nombramientos')
cursor	integer	optional	id de acto desde el que continuar (paginación)
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "empresa_id": {
      "type": "integer"
    },
    "desde": {
      "type": "string",
      "description": "Fecha ISO (YYYY-MM-DD); solo actos publicados desde entonces"
    },
    "tipo": {
      "type": "string",
      "description": "Filtra por tipo de concepto (p.ej. 'nombramientos')"
    },
    "cursor": {
      "type": "integer",
      "description": "id de acto desde el que continuar (paginación)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  },
  "required": [
    "empresa_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

asientouno_cargos_persona

Busca una persona por nombre y devuelve sus cargos vigentes e históricos, con las empresas vinculadas (grafo de relacionadas).

Parameters2

nombre	string	optional	Nombre completo o parcial de la persona
persona_id	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "nombre": {
      "type": "string",
      "description": "Nombre completo o parcial de la persona"
    },
    "persona_id": {
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

asientouno_riesgo_empresa

Señales de riesgo de una empresa publicadas en el BORME: concurso de acreedores (declaración y conclusión), otras situaciones concursales, disolución y extinción, con la fecha y el PDF oficial de cada una. Pensado para diligencia debida, prevención de blanqueo y análisis de crédito. La respuesta incluye un campo `cobertura` que explica qué NO cubre — no asumir ausencia de riesgo por ausencia de señales.

Parameters1

empresa_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "empresa_id": {
      "type": "integer"
    }
  },
  "required": [
    "empresa_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

asientouno_subvenciones_empresa

Subvenciones y ayudas públicas recibidas por una empresa (fuente oficial: Base de Datos Nacional de Subvenciones, BDNS): organismo concedente, instrumento, importe y fecha de cada concesión, con enlace al boletín oficial. Dato que los informes mercantiles tradicionales no cruzan.

Parameters3

empresa_id	integer	required
cursor	integer	optional	id desde el que continuar (paginación)
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "empresa_id": {
      "type": "integer"
    },
    "cursor": {
      "type": "integer",
      "description": "id desde el que continuar (paginación)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  },
  "required": [
    "empresa_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

asientouno_contratos_empresa

Contratos públicos adjudicados a una empresa (fuente oficial: Plataforma de Contratación del Sector Público, PLACSP): órgano de contratación, expediente, importe y fecha de cada adjudicación, con enlace al detalle oficial.

Parameters3

empresa_id	integer	required
cursor	integer	optional	id desde el que continuar (paginación)
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "empresa_id": {
      "type": "integer"
    },
    "cursor": {
      "type": "integer",
      "description": "id desde el que continuar (paginación)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  },
  "required": [
    "empresa_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

asientouno_cuentas_anuales

Cuentas anuales de una empresa para un ejercicio. Nota: compra bajo demanda es Fase 2 — hoy responde honestamente que no está disponible.

Parameters2

empresa_id	integer	required
ejercicio	string	required	Año del ejercicio, p.ej. '2025'

Raw schema

{
  "type": "object",
  "properties": {
    "empresa_id": {
      "type": "integer"
    },
    "ejercicio": {
      "type": "string",
      "description": "Año del ejercicio, p.ej. '2025'"
    }
  },
  "required": [
    "empresa_id",
    "ejercicio"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md5 KBView on GitHub

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.

Install

Tools (8)

asientouno_buscar_empresaasientouno_informe_completoasientouno_actos_bormeasientouno_cargos_personaasientouno_riesgo_empresaasientouno_subvenciones_empresaasientouno_contratos_empresaasientouno_cuentas_anuales

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.asientouno.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "asientouno": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.asientouno.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: io.github.odela-pixel/asientouno

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

asientouno_buscar_empresa

asientouno_informe_completo

asientouno_actos_borme

asientouno_cargos_persona

asientouno_riesgo_empresa

asientouno_subvenciones_empresa

asientouno_contratos_empresa

asientouno_cuentas_anuales

Asiento Uno — servidor MCP del Registro Mercantil español

Herramientas

Conseguir una API key

Conectar

Claude Desktop / Claude Code (vía mcp-remote)

Cualquier cliente MCP con transporte HTTP

Cifras (26/09/2026)

Lo que este servidor NO hace

Fuentes y límites, dichos claros

Licencia

Install

Remote endpoint

Related servers

Claude Desktop / Claude Code (vía `mcp-remote`)