MCP server for AI assistants

Use Spanish company data from Claude, ChatGPT, Cursor or any MCP client: lookups by CIF, name search, directors, BORME filings and more.

Base URL: https://spaincompanyapi.com/api/v1 · API key in the X-API-KEY header · Get a free API key (100 requests, no card) · Full documentation

15.1 AI assistants (MCP)

Connect the API to Claude, Cursor, VS Code or any MCP-compatible assistant and ask in plain language: "Is Mercadona active and who are its directors?", "get the CIF of these 40 companies", "who is the sole shareholder of B12345678?". The assistant calls the API with your key and answers with the data.

There are two ways to connect it: the remote server, with nothing to install, or the npm package. This is the official server: apiempresas-mcp on npm, source on GitHub, listed in the official MCP Registry as io.github.abasmartinc/apiempresas. The package requires Node.js 18 or later.

Nothing to install: remote server

The server URL is https://apiempresas.es/api/mcp (HTTP transport). Send your key in the X-API-KEY header (or Authorization: Bearer your_api_key) or, if the assistant does not let you set headers, at the end of the URL: https://apiempresas.es/api/mcp/your_api_key.

Without a key: if you connect the URL without a key, search_companies and get_company work with Free-plan data (address hidden, no directors), up to 60 requests per hour and 300 per day from each connection, at no cost. The other tools ask for the key. It is a one-minute way to try it; for real use, create a free key.

  • Claude (web and app): in Settings → Connectors, add a custom connector with the URL https://apiempresas.es/api/mcp, no sign-in (no OAuth), and the X-API-KEY header with your key. If you don't see the headers option, use the URL with the key at the end.
  • ChatGPT: turn on developer mode and create a new connector with the URL that has your key at the end and "No Auth" authentication.

Claude Code:

claude mcp add --transport http apiempresas https://apiempresas.es/api/mcp --header "X-API-KEY: your_api_key"

Cursor (~/.cursor/mcp.json) and VS Code (.vscode/mcp.json, with "servers" instead of "mcpServers"):

{
  "mcpServers": {
    "apiempresas": {
      "type": "http",
      "url": "https://apiempresas.es/api/mcp",
      "headers": { "X-API-KEY": "your_api_key" }
    }
  }
}

The URL with your key works like a password: anyone who has it spends queries from your account. Don't share it; if it leaks, rotate the key in your dashboard.

With the npm package (on your computer)

Claude Desktop and Cursor

In claude_desktop_config.json (Claude Desktop) or ~/.cursor/mcp.json (Cursor):

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

Claude Code

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

VS Code

In .vscode/mcp.json:

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

Tools

ToolWhat it doesPlan
get_companyCompany by CIF: status, legal form, LEI, CNAE; address, sole shareholder, parent company and directors depending on planFree (trimmed), Pro
search_companiesSearch companies by nameFree
verify_companyOne-call KYB verification (2 requests)Pro
find_cif_by_nameName to CIF, up to 100 at a time (only matches are charged)Pro
verify_invoice_recipientsChecks a list of customers (up to 100) before invoicing them: official legal name and address, status and invoice_hint ok / revisar (review) / no_facturar (do not invoice) (1 request per company found)Pro
get_borme_historyBORME filingsPro
get_risk_profileRisk profileBusiness
get_public_contractsAwarded public contractsBusiness
get_subsidiesPublic grants and subsidies (BDNS since 2022, Kit Digital included), with a summary by year and callBusiness
search_tendersOpen public tenders, by filters or similar to what a company has already wonBusiness
check_sanctionsSanctions screening (EU, UN, OFAC) of a company and its directors, or of a nameBusiness
get_usagePlan, remaining requests and credit balance (free)All
  • Each call by the assistant uses requests from your plan, just like the API. All tools are read-only.
  • To test without spending, add "APIEMPRESAS_BASE_URL": "https://apiempresas.es/api/sandbox/v1" to env (test CIFs A15075062 and B00000000 only).
  • No key yet? Create a free account: 100 requests, no card.

🚀 Ready to get started?

Get your API Key in seconds and start integrating real data into your applications.

Go to Control Panel
🤖
Asistente IA En línea
¡Hola! Soy el asistente de APIEmpresas. ¿En qué puedo ayudarte hoy?