APIEmpresas – Spanish Company Data

Look up any Spanish company by name or tax ID (CIF): registry status, legal form, LEI, revoked tax IDs and company filing statistics from the Mercantile Registry gazette (BORME). No API key needed.

託管 MCP 伺服器

npx add-mcp 'https://apiempresas.es/api/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

APIEmpresas MCP

Servidor MCP oficial de APIEmpresas.es: datos de empresas españolas para Claude, Cursor, VS Code y cualquier asistente compatible con MCP.

Pregunta en lenguaje natural ("¿Mercadona está activa y quiénes son sus administradores?", "saca el CIF de estas 40 empresas", "¿esta empresa ha tenido un concurso?") y el asistente consulta la API con tu clave.

Herramientas

HerramientaQué hacePlan
get_companyEmpresa por CIF: razón social, estado, constitución, provincia, CNAE, forma jurídica (ISO 20275) y LEI; domicilio, socio único, matriz del grupo y administradores según planFree (datos recortados), Pro
search_companiesBuscar empresas por nombreFree
verify_companyVerificación KYB: existe, activa, nombre y administrador (o socio único) coinciden y, si se pide, NIF-IVA en VIES; con forma jurídica, LEI, matriz y socio único (2 consultas)Pro
find_cif_by_nameDe nombre a CIF, hasta 100 a la vez, con provincia opcional para desempatar (solo cobra las coincidencias)Pro
verify_invoice_recipientsValida una lista de clientes (hasta 100) antes de facturarles: razón social y domicilio oficiales, estado y invoice_hint ok / revisar / no_facturar, con sus motivos; con vat, también VIES (hasta 20). Solo cobra las sociedades encontradas (desde 1.4.0)Pro
get_borme_historyActos publicados en el BORMEPro
get_risk_profilePerfil de riesgo a partir del BORMEBusiness
get_public_contractsContratos públicos adjudicadosBusiness
get_subsidiesSubvenciones y ayudas públicas de la BDNS desde 2022 (Kit Digital incluido): resumen por año, instrumento y convocatoria, y las concesiones (desde 1.3.0)Business
search_tendersLicitaciones públicas abiertas: por palabras, CPV, provincia, tipo e importe, o parecidas a lo que ya ha ganado una empresa (cif)Business
check_sanctionsListas de sanciones de la UE, la ONU y OFAC: una empresa y sus administradores (cif) o un nombre (name), con el grado de cada coincidenciaBusiness
get_usagePlan, consultas disponibles y saldo de créditos (gratis; no funciona en el Sandbox)Todos

Todas son de solo lectura. Cada llamada gasta consultas de tu plan, igual que la API.

Instalación

  1. Crea una cuenta gratis (100 consultas, sin tarjeta) en apiempresas.es y copia tu API key del panel.
  2. Añade el servidor a tu cliente (necesita Node.js 18 o superior).

Claude Desktop

En claude_desktop_config.json:

{
  "mcpServers": {
    "apiempresas": {
      "command": "npx",
      "args": ["-y", "apiempresas-mcp"],
      "env": { "APIEMPRESAS_API_KEY": "tu_api_key" }
    }
  }
}

Claude Code

claude mcp add apiempresas --env APIEMPRESAS_API_KEY=tu_api_key -- npx -y apiempresas-mcp

Cursor

En ~/.cursor/mcp.json (o .cursor/mcp.json en el proyecto), el mismo bloque mcpServers que en Claude Desktop.

VS Code

En .vscode/mcp.json:

{
  "servers": {
    "apiempresas": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "apiempresas-mcp"],
      "env": { "APIEMPRESAS_API_KEY": "tu_api_key" }
    }
  }
}

Pruebas sin coste

Con APIEMPRESAS_BASE_URL=https://apiempresas.es/api/sandbox/v1 las llamadas no gastan consultas (solo admite los CIF de prueba A15075062 y B00000000).

Qué conviene saber

  • El estado registral, el scoring y el perfil de riesgo los calcula APIEmpresas a partir del BORME: no son un certificado del Registro Mercantil.
  • No cubre titular real, listas de sanciones o PEP, ni empresarios individuales (autónomos).
  • Precios: Free 100 consultas; Pro 19 €/mes (3.000/mes); Business 49 €/mes (10.000/mes); bonos sin suscripción desde 9 €. IVA no incluido. Detalle en apiempresas.es.
  • Documentación completa de la API: apiempresas.es/documentation.

English

Official MCP server for APIEmpresas.es, a REST API for Spanish company data: lookup by CIF (tax ID), name search, KYB verification, bulk tax ID checks of invoice recipients (verify_invoice_recipients), directors, BORME (Commercial Registry gazette) filings, public contracts and risk profile. Get a free API key (100 requests) at apiempresas.es and run npx -y apiempresas-mcp with APIEMPRESAS_API_KEY set.

Licencia

MIT