entia-mcp-server

# ENTIA MCP Server

**Structured business intelligence for AI agents.**

ENTIA provides verified entity data across 10 countries — accessible via [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) or REST API.

| Metric | Value |
|---|---|
| Verified entities | 11,330,392 |
| Countries | 10 |
| BORME mercantile acts | 40.3M |
| Healthcare professionals | 570K+ |
| MCP tools | 12 |
| REST endpoints | 4 |

## Quick Start (< 2 minutes)

### Option 1: Remote MCP Server (recommended)

No installation needed. Connect your MCP client directly:

**Claude Desktop** — add to `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "entia": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.entia.systems/mcp"]
    }
  }
}
```

**Cursor IDE** — add to `.cursor/mcp.json`:
```json
{
  "mcpServers": {
    "entia": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.entia.systems/mcp"]
    }
  }
}
```

Then try:
```
Look up Telefonica in Spain
```

### Option 2: REST API

```bash
# Search entities
curl "https://entia.systems/v1/search?q=telefonica&country=ES&limit=5" \
  -H "X-ENTIA-Key: YOUR_API_KEY"

# Full entity profile (BORME + GLEIF + VIES + Wikidata)
curl "https://entia.systems/v1/profile/Telefonica?country=ES"

# EU VAT verification
curl "https://entia.systems/v1/verify/vat/ESA28015865"

# Platform stats
curl "https://entia.systems/v1/stats"
```

### Option 3: Python client (in this repo)

A Python client lives in this repo under `entia_mcp/` (wraps a subset of tools as convenience methods). The full 12-tool surface is always available via the hosted endpoint (Option 1). A published PyPI package is planned.

## 12 MCP Tools

| Tool | What it does |
|---|---|
| `entity_lookup` | Verify identity of any business by name, CIF/NIF, EU VAT or LEI. Cross-checks BORME, VIES, GLEIF. |
| `search_entities` | Search verified entities across 10 countries by name, keyword, country, or sector. |
| `verify_vat` | Real-time EU VAT validation via VIES (27 member states). |
| `zone_profile` | Spanish socioeconomic profile by postal code (INE/SEPE/AEAT): income, employment, business density. |
| `get_competitors` | Real competitors in the same sector and geography. |
| `get_showcase` | Curated IBEX35 + EU showcase entities. Free, does not consume quota. |
| `professional_lookup` | Verify professional registrations across 24 Spanish health/legal/psychology verticals. Requires DPA (GDPR Art. 28). |
| `get_full_dossier` | Aggregator: 90+ fields about an entity in one call (combines 4 ENTIA sources). |
| `get_platform_stats` | Live platform stats: entities, countries, sources. |
| `run_risk_audit` | AI-readiness + digital risk audit for any domain. |
| `get_entia_home` | Full Schema.org JSON-LD @graph for an entity (Entia Home). |
| `get_entity_home_projection` | Machine-readable projection of an Entia Home record (v1). |

## Pricing

Free tier: **100 requests/month**. Authoritative pricing is published live at
[entia.systems/.well-known/ai-pricing.json](https://entia.systems/.well-known/ai-pricing.json).

| Tier | Price | Requests | Overage |
|---|---|---|---|
| TRACE | Free | 100/month | Hard block |
| SIGNAL | EUR 29/month | 500/month | Hard block |
| BUILD | EUR 99/month | 2,500/month | Hard block |
| INTEGRATE | EUR 399/month | 10,000/month | EUR 0.15/req |
| OPERATE | EUR 1,499/month | 100,000/month | EUR 0.10/req |
| SCALE | EUR 2,500+/month | 500,000/month | EUR 0.05/req (contact) |
| ENTERPRISE | Custom | Unlimited | — |

Get your API key: [entia.systems/mcp-setup](https://entia.systems/mcp-setup)

## Data Sources

All data comes from official public registries:

- **BORME** -- Spanish Mercantile Registry (BOE)
- **VIES** -- EU VAT validation (European Commission)
- **GLEIF** -- Legal Entity Identifiers (Global LEI Foundation)
- **Wikidata** -- Knowledge Graph (Wikimedia Foundation)
- **REPS** -- Spanish Healthcare Professionals Registry
- **INE** -- Spanish National Statistics Institute
- **SEPE** -- Spanish Employment Service
- **AEAT** -- Spanish Tax Authority
- **Companies House** -- UK company registry
- **Sirene/INSEE** -- French company registry

## Links

- [API Documentation](https://entia.systems/mcp-docs)
- [Get API Key](https://entia.systems/mcp-setup)
- [Setup Guide](https://entia.systems/mcp-setup)
- [Client Dashboard](https://entia.systems/mcp-dashboard)
- [Official MCP Registry](https://registry.modelcontextprotocol.io)

## About

Built by [PrecisionAI Marketing OU](https://entia.systems) (Estonia, EU).

- VAT: EE102780516
- DUNS: 565868914
- e-Residency certified
- eIDAS compliant

## License

**Code: MIT** (see [`LICENSE`](LICENSE)). This server is a thin MCP wrapper: it
speaks JSON-RPC and proxies to the ENTIA API. Keeping the wrapper open is
deliberate — it lets any client audit exactly what is sent and returned.

**Data: proprietary — MIT does not apply to it.** The verified-entity corpus
reached through this server is licensed separately and access is controlled by
API key. Use of the data is governed by the
[Data Licensing Framework](https://entia.systems/legal/data-licensing),
the [MCP Terms](https://entia.systems/legal/mcp-terms) and the
[Terms of Service](https://entia.systems/legal/terms), and is protected by the
sui generis database right (Directive 96/9/EC). Cloning this repository grants
no right whatsoever over the corpus.

<!-- last-synced: 2026-08-18 — verificado contra tools/list en vivo de https://mcp.entia.systems/mcp (12 tools) y /.well-known/ai-pricing.json v1.5.1 (TRACE 100/month). -->