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 theX-API-KEYheader 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
| Tool | What it does | Plan |
|---|---|---|
get_company | Company by CIF: status, legal form, LEI, CNAE; address, sole shareholder, parent company and directors depending on plan | Free (trimmed), Pro |
search_companies | Search companies by name | Free |
verify_company | One-call KYB verification (2 requests) | Pro |
find_cif_by_name | Name to CIF, up to 100 at a time (only matches are charged) | Pro |
verify_invoice_recipients | Checks 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_history | BORME filings | Pro |
get_risk_profile | Risk profile | Business |
get_public_contracts | Awarded public contracts | Business |
get_subsidies | Public grants and subsidies (BDNS since 2022, Kit Digital included), with a summary by year and call | Business |
search_tenders | Open public tenders, by filters or similar to what a company has already won | Business |
check_sanctions | Sanctions screening (EU, UN, OFAC) of a company and its directors, or of a name | Business |
get_usage | Plan, 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"toenv(test CIFs A15075062 and B00000000 only). - No key yet? Create a free account: 100 requests, no card.
More API documentation
- Authentication, plans and limits
- Spanish company lookup by CIF or name
- KYB verification and tax ID checks
- BORME API: registry filings as JSON
- Company monitoring: watchlist and webhooks
- Prospecting: new companies and segments
- Public contracts, tenders and grants
- Sanctions screening and risk profile
- MCP server for AI assistants
- SDKs, code examples and Postman
🚀 Ready to get started?
Get your API Key in seconds and start integrating real data into your applications.
Go to Control Panel