io.github.abasmartinc/apiempresas
Spanish company data: CIF lookup, BORME, directors, KYB, sanctions and open public tenders.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
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.>'{
"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.>"
}
}
}
}apiempresas-mcpclaude mcp add apiempresas -e 'APIEMPRESAS_API_KEY=<your apiempresas_api_key>' -- npx -y apiempresas-mcp@1.4.0{
"mcpServers": {
"apiempresas": {
"command": "npx",
"args": [
"-y",
"apiempresas-mcp@1.4.0"
],
"env": {
"APIEMPRESAS_API_KEY": "<your apiempresas_api_key>"
}
}
}
}Variables d'environnement
APIEMPRESAS_API_KEYobligatoire secret API key from https://apiempresas.es/dashboard (free plan: 100 requests, no card)
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
| Herramienta | Qué hace | Plan |
|---|---|---|
get_company | Empresa 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 plan | Free (datos recortados), Pro |
search_companies | Buscar empresas por nombre | Free |
verify_company | Verificació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_name | De nombre a CIF, hasta 100 a la vez, con provincia opcional para desempatar (solo cobra las coincidencias) | Pro |
get_borme_history | Actos publicados en el BORME | Pro |
get_risk_profile | Perfil de riesgo a partir del BORME | Business |
get_public_contracts | Contratos públicos adjudicados | Business |
get_subsidies | Subvenciones 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_tenders | Licitaciones públicas abiertas: por palabras, CPV, provincia, tipo e importe, o parecidas a lo que ya ha ganado una empresa (cif) | Business |
check_sanctions | Listas de sanciones de la UE, la ONU y OFAC: una empresa y sus administradores (cif) o un nombre (name), con el grado de cada coincidencia | Business |
get_usage | Plan, 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
- Crea una cuenta gratis (100 consultas, sin tarjeta) en apiempresas.es y copia tu API key del panel.
- 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-mcpCursor
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
Questions fréquentes
Qu'est-ce que io.github.abasmartinc/apiempresas ?
Spanish company data: CIF lookup, BORME, directors, KYB, sanctions and open public tenders.
Comment installer io.github.abasmartinc/apiempresas ?
Il fonctionne comme serveur distant. Dans 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.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.abasmartinc/apiempresas ?
Oui. Il attend APIEMPRESAS_API_KEY, X-API-KEY, à renseigner dans sa configuration.
io.github.abasmartinc/apiempresas est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.abasmartinc/apiempresas ?
Il est publié par abasmartinc. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.