MCP Setup Guide
Connect ENTIA to your AI
in 60 seconds
11.3M canonical entities across 10 published registry-corpus countries. Entia Home launch scope: 51 countries. 12 tools, one server. Get a free key, copy one config block, restart your client. Done.
Free — 100 calls/month 60 seconds setupStay in the loop
Not ready to connect? Leave your email — we send one setup tip (no spam). Builder bounty →
Agent / machine path
No browser. No Turnstile. When a tool returns API key required with a signup object:
1) tools/call (no key) → isError + signup.url
2) POST https://api.entia.systems/api/v1/mcp/register
{"email":"owner@company.com","first_name":"Ana","last_name":"García",
"company":"Company SL","consent":true,"source":"self_serve_machine"}
consent=true: the key owner authorizes ENTIA to store these data
(text and version: https://entia.systems/mcp-setup#free-key)
→ 201 { "key": "entia_live_…", "tier": "trace", "quota": { "limit": 100 } }
3) Store the key (shown once)
4) Retry with header X-ENTIA-Key: <key>
MCP: https://mcp.entia.systems/mcp
source must be self_serve_machine (agents) or mcp_setup (humans + Turnstile).
TRACE = 100 calls/mo free. Paid tools use options.buy_now → Stripe checkout.
Full docs: /mcp-docs#agent-self-register · Pricing: ai-pricing.json
Listed for agent builders
Get your free API key
TRACE tier — 100 calls/month, no card required. Fill in who the key belongs to and it is issued on this page, instantly. No call, no demo, no waiting.
Anthropic's desktop app for Mac and Windows
Open your config file
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Paste this configuration
{
"mcpServers": {
"entia": {
"url": "https://mcp.entia.systems/mcp",
"headers": { "x-entia-key": "YOUR_API_KEY" }
}
}
}
Replace YOUR_API_KEY with your key — get one free above.
Restart Claude Desktop and try:
"Look up Telefonica in ENTIA"
"Get the full dossier of Inditex"
"Verify VAT number ESA28015865"
AI-first code editor — Settings → MCP
Open Cursor Settings → MCP → Add Server
Or edit ~/.cursor/mcp.json
Paste this configuration
{
"mcpServers": {
"entia": {
"url": "https://mcp.entia.systems/mcp",
"headers": { "x-entia-key": "YOUR_API_KEY" }
}
}
}
Replace YOUR_API_KEY with your key — get one free above.
Restart Cursor and ask the AI:
"Search for dental clinics in Barcelona using ENTIA"
Codeium's AI IDE
Open ~/.codeium/windsurf/mcp_config.json
Paste this configuration
{
"mcpServers": {
"entia": {
"url": "https://mcp.entia.systems/mcp",
"headers": { "x-entia-key": "YOUR_API_KEY" }
}
}
}
Replace YOUR_API_KEY with your key — get one free above.
MCP extension for Visual Studio Code
Install Cline extension, then open MCP Settings
{
"mcpServers": {
"entia": {
"url": "https://mcp.entia.systems/mcp",
"headers": { "x-entia-key": "YOUR_API_KEY" }
}
}
}
Replace YOUR_API_KEY with your key — get one free above.
For custom integrations — no npx needed
import requests
r = requests.post(
"https://mcp.entia.systems/mcp",
headers={"x-entia-key": "YOUR_API_KEY"},
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "entity_lookup",
"arguments": {"q": "Telefonica"}
}
})
print(r.text)
Replace YOUR_API_KEY with your key — get one free above.
What can you ask?
Once connected, just talk to your AI naturally:
What your AI gets access to
11.3M+ verified business records across 10 countries. 12 tools registered — 11 in production, 1 enterprise (DPA required), 0 on the roadmap: a tool is production-grade or it is not listed. The live tools/list is authoritative.
Also registered: professional_lookup (enterprise, DPA required). The authoritative list is always tools/list on the live server.
Pricing
Start for free. Upgrade when your agent needs it.
Instant checkout via Stripe. Your API key is revealed once after payment — it is never sent by email. Manage keys in your account portal.