English Français العربية

io.github.abasmartinc/apiempresas

Official registry Other

Spanish company data: CIF lookup, BORME, directors, KYB, sanctions and open public tenders.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http apiempresas 'https://apiempresas.es/api/mcp' --header 'X-API-KEY: <Optional. API key from https://apiempresas.es/dashboard (free plan: 100 requests, no card). Without a key, name search and basic company data still work.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "apiempresas": {
            "type": "http",
            "url": "https://apiempresas.es/api/mcp",
            "headers": {
                "X-API-KEY": "<Optional. API key from https://apiempresas.es/dashboard (free plan: 100 requests, no card). Without a key, name search and basic company data still work.>"
            }
        }
    }
}
NPM package apiempresas-mcp
Claude Code 
claude mcp add apiempresas -e 'APIEMPRESAS_API_KEY=<your apiempresas_api_key>' -- npx -y apiempresas-mcp@1.4.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "apiempresas": {
            "command": "npx",
            "args": [
                "-y",
                "apiempresas-mcp@1.4.0"
            ],
            "env": {
                "APIEMPRESAS_API_KEY": "<your apiempresas_api_key>"
            }
        }
    }
}

Environment variables

  • APIEMPRESAS_API_KEY required secret API key from https://apiempresas.es/dashboard (free plan: 100 requests, no card)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. APIEmpresas MCP
  2. Herramientas
  3. Instalación
  4. Qué conviene saber
  5. English
  6. Licencia

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

Frequently asked questions

What is io.github.abasmartinc/apiempresas?

Spanish company data: CIF lookup, BORME, directors, KYB, sanctions and open public tenders.

How do I install io.github.abasmartinc/apiempresas?

It runs as a remote server. In Claude Code: claude mcp add --transport http apiempresas 'https://apiempresas.es/api/mcp' --header 'X-API-KEY: <Optional. API key from https://apiempresas.es/dashboard (free plan: 100 requests, no card). Without a key, name search and basic company data still work.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.abasmartinc/apiempresas need an API key?

Yes. It expects APIEMPRESAS_API_KEY, X-API-KEY, which you set in its configuration.

Is io.github.abasmartinc/apiempresas open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.abasmartinc/apiempresas?

It is published by abasmartinc. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.