APIEmpresas: Spanish company data

io.github.abasmartincPublished by GitHub account abasmartincv1.4.2Updated Nov 7, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinanceBusiness & Commerce

Overview

AI-generated overview

Official APIEmpresas MCP server for Spanish company data: CIF lookup, name search, KYB checks, BORME filings, risk, sanctions and public tenders.

What you can do
  • Look up a Spanish company by CIF or search by name, and resolve lists of names to CIFs
  • Run KYB verification of a company, its signing director and optional VAT/EORI checks
  • Validate lists of invoice recipients with an ok / review / do-not-invoice hint
  • Retrieve BORME filings, a BORME-based risk profile, awarded public contracts and BDNS subsidies
  • Search open public tenders by keyword, CPV, province, type or amount, and screen EU, UN and OFAC sanctions lists
  • Check plan, remaining queries and credit balance
When to use it
Useful when an assistant must check or enrich Spanish company records: onboarding customers or suppliers, validating invoice recipients, assessing counterparty risk before credit or contracts, or prospecting public tenders and subsidies.
Requirements
Runs as a remote endpoint or as a local npm package (apiempresas-mcp) via npx, needing Node.js 18 or higher. An API key from the provider's dashboard is set as APIEMPRESAS_API_KEY (or the X-API-KEY header); without a key only name search and basic company data work, with a daily limit. A free plan offers 100 queries; paid plans are billed monthly.
Before you install
Every call consumes plan queries, so costs accrue with use; paid plans are 19 EUR and 49 EUR per month plus VAT. The API key is a secret and should be kept out of shared configs. Registry status, scoring and risk profiles are computed by the provider from BORME, not an official Commercial Registry certificate, and the data excludes beneficial owners, PEP lists and sole traders.

Installation

In SourceWeft

  1. Open APIEmpresas: Spanish company data in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.abasmartinc%2Fapiempresas/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "apiempresas-spanish-company-data": {
      "type": "http",
      "url": "https://apiempresas.es/api/mcp"
    }
  }
}

README

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:

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

Claude Code

bash
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:

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

Source: README.md at commit 12eba19

Tools

12

get_company

Empresa por CIF

Ficha de UNA empresa española cuando ya tienes su CIF/NIF. Úsala para saber si existe y está activa, su razón social, forma jurídica (con código ISO 20275), código LEI, CNAE, provincia y fecha de constitución; con plan Pro, también domicilio, tramo de facturación, socio único, matriz del grupo y, con include_directors, los administradores vigentes, el tramo de empleados y cuántas sociedades comparten su domicilio (domicilio masivo). Si no tienes el CIF, usa search_companies; para decidir un alta (KYB), verify_company. Gasta 1 consulta; sin API key funciona con los datos básicos y un límite diario. Spanish company lookup by tax ID.

Parameterscifrequiredinclude_directors

search_companies

Buscar empresas por nombre

Busca empresas españolas por nombre o parte del nombre y devuelve las candidatas con su CIF, provincia y estado. Úsala cuando NO tienes el CIF de una empresa concreta; después, get_company con el CIF elegido. Para convertir una lista de muchos nombres en CIF, mejor find_cif_by_name. Sin API key funciona con hasta 10 resultados y un límite diario. Search Spanish companies by name.

Parameterslimitqueryrequired

verify_company

Verificación KYB

Verificación para dar de alta a un cliente o proveedor (KYB) en una llamada: comprueba que la sociedad existe y opera, que la razón social que te han dado coincide (name), que quien firma es administrador vigente o socio único (person) y, si se pide, el NIF-IVA en VIES (vat) y si tiene EORI para importar y exportar fuera de la UE (eori). Avisa si el domicilio lo comparten muchas sociedades (domicilio masivo). Devuelve alertas y una recomendación pass / review / fail, además de forma jurídica, LEI, matriz y socio único. Úsala para decidir; para solo consultar datos, get_company. Plan Pro; gasta 2 consultas. KYB check for a Spanish company.

Parameterscifrequiredvateorinameperson

find_cif_by_name

De nombre a CIF (lista)

Convierte una LISTA de nombres de empresa (hasta 100) en sus CIF, con resultado match, ambiguous o no_match para cada uno. Úsala para completar hojas de clientes o proveedores que solo tienen el nombre. Solo los match gastan consulta. Para un solo nombre, search_companies. Plan Pro.

Parametersnamesrequiredprovince

verify_invoice_recipients

Validar NIF de clientes para facturar

Valida una LISTA de clientes (hasta 100) antes de emitirles facturas (Verifactu, factura electrónica): por cada NIF, si el formato es válido, si la sociedad consta, su razón social y domicilio oficiales, su estado y, si das el nombre que tienes guardado, si coincide. Devuelve invoice_hint ok / revisar / no_facturar con los motivos (extinguida, absorbida, en concurso, nombre distinto, NIF de ejemplo...). Úsala para revisar la cartera de clientes de un programa de facturación o ERP; para dar de alta a un solo cliente con más detalle, verify_company. No sustituye al censo de la AEAT. Plan Pro, Business o saldo; gasta 1 consulta por sociedad encontrada (lo que no consta no se cobra). Bulk VAT/tax ID check of invoice recipients.

Parametersvatitemsrequired

get_borme_history

Historial del BORME

Todos los actos publicados en el BORME de una empresa, con fecha y PDF oficial: constitución, nombramientos y ceses, ampliaciones de capital, cambios de domicilio o de nombre, disolución, concurso... Úsala para la historia y los cambios recientes; para el estado actual basta get_company. Plan Pro.

Parameterscifrequired

get_risk_profile

Perfil de riesgo

Nivel de riesgo de una empresa y sus motivos, calculado a partir de sus publicaciones en el BORME (concursos, disoluciones, cierres de hoja registral, cuentas no depositadas, cambios de administradores...). Úsala antes de dar crédito o firmar con un proveedor. Plan Business.

Parameterscifrequired

get_public_contracts

Contratos públicos

Contratos del sector público adjudicados a una empresa (Plataforma de Contratación del Sector Público): organismo, objeto, importe y fecha. Plan Business.

Parameterscifrequiredpagelimit

get_subsidies

Subvenciones y ayudas públicas

Subvenciones, préstamos, garantías y ventajas fiscales concedidos a una empresa española según la Base de Datos Nacional de Subvenciones (BDNS), desde 2022, Kit Digital incluido: resumen por año, por instrumento y las convocatorias con más importe, y la lista de concesiones. Úsala para prospección de ayudas o para saber cuánto dinero público recibe. Plan Business; gasta 1 consulta. Public grants received by a Spanish company.

Parameterscifrequiredyearlimit

search_tenders

Licitaciones públicas abiertas

Licitaciones públicas EN PLAZO en España (Plataforma de Contratación del Sector Público y plataformas autonómicas): título, organismo, provincia, importe, plazo de ofertas, CPV y enlace para presentarse. Filtra por palabras del título (query), CPV, provincia, tipo (supplies, services, works) e importe. Con cif, devuelve las abiertas parecidas a los contratos que esa empresa ya ha ganado: úsala para "¿a qué concursos se puede presentar esta empresa?". Plan Business; gasta 1 consulta. Open public tenders in Spain.

Parameterscifcpvtypelimitqueryprovincemax_amountmin_amount

check_sanctions

Listas de sanciones

Comprueba si una empresa española (por cif, junto con sus administradores vigentes) o un nombre suelto (name) aparece en las listas de sanciones de la UE, la ONU y OFAC (EE. UU.). Devuelve cada coincidencia con su grado (strong o possible), la lista, el programa, la fecha, el país y la fecha de nacimiento para confirmarla o descartarla: un nombre parecido no es una coincidencia confirmada. Úsala en altas de clientes o proveedores (KYB, prevención de blanqueo). Plan Business; gasta 1 consulta. Sanctions screening (EU, UN, OFAC).

Parameterscifnametype

get_usage

Consumo de la cuenta

Plan de la cuenta del usuario, consultas usadas y disponibles y saldo de créditos. No gasta consultas. Úsala si una herramienta responde que se ha agotado el cupo.

Takes no parameters.

Version history

6
  1. v1.4.2LatestNov 7, 2026
  2. v1.4.1Oct 30, 2026
  3. v1.4.0Oct 26, 2026
  4. v1.3.0Oct 20, 2026
  5. v1.2.0Oct 18, 2026
  6. v1.1.0Oct 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts