Skip to content

Repository files navigation

ENTIA MCP Server

Structured business intelligence for AI agents.

ENTIA provides verified entity data across 10 countries — accessible via Model Context Protocol (MCP) 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:

{
  "mcpServers": {
    "entia": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.entia.systems/mcp"]
    }
  }
}

Cursor IDE — add to .cursor/mcp.json:

{
  "mcpServers": {
    "entia": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.entia.systems/mcp"]
    }
  }
}

Then try:

Look up Telefonica in Spain

Option 2: REST API

# 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.

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

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

About

Built by PrecisionAI Marketing OU (Estonia, EU).

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

License

Code: MIT (see 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, the MCP Terms and the Terms of Service, and is protected by the sui generis database right (Directive 96/9/EC). Cloning this repository grants no right whatsoever over the corpus.

About

Verified business-identity intelligence for AI agents & MCP clients — company verification, VAT/BORME/GLEIF, ownership & risk signals across 10 countries. Remote MCP server, free tier.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages