io.github.entia-systems-core/entity-verification

Official13 tools

by ENTIA-IA · Python

ENTIA Entity Verification

Verified business identity for AI agents: VAT, BORME, GLEIF checks, 34 countries. Free tier.

Business verification across 34 countries using public registries and data sources.

Topics

ai-agentsbusiness-intelligenceentity-verificationlangchainmcpmcp-server

Captured live from the server via tools/list.

entity_lookup

Look up any business entity by name, CIF/NIF, EU VAT, or LEI. Auto-detects input type. Public endpoint (no API key required, 10 req/min).

Parameters (1)

qstringrequired
Company name, CIF/NIF (B82846825), EU VAT (ESB82846825), or LEI (20 chars)

search_entities

Search verified entities across 34 countries by name, keyword, country, or sector. Requires API key (10 req/min).

Parameters (4)

qstringrequired
Search query — company name or keywords
countrystring
ISO country code (es, gb, fr)
sectorstring
Sector filter (dental, legal, talleres, estetica, …)
limitinteger
Max results (default 10, max 50)

verify_vat

Real-time EU VAT validation via VIES (27 countries). Returns {valid, name, address, vat_number, country}.

Parameters (1)

qstringrequired
EU VAT number (ESA28015865, A28015865, IE6388047V)

zone_profile

Socioeconomic profile of a Spanish postal code — 17 blocks: income, employment, demographics, business census, real estate, FTTH, poverty, tourism.

Parameters (1)

postal_codestringrequired
Spanish 5-digit postal code (28013 = Madrid Gran Vía)

ai_ready_profile

Full AI-ready JSON-LD profile for any entity — 4-node @graph (Organization, Place, LocalBusiness, PostalAddress). Designed for direct AI citation.

Parameters (1)

querystringrequired
Company name or domain

get_competitors

Find real competitors in the same sector and geography. Ranked entities with identity + location + sector matching.

Parameters (3)

sectorstringrequired
ENTIA sector slug (estetica, dental, psicologia, legal, …)
citystringrequired
City name (Madrid, Barcelona, London, Paris)
limitinteger

get_showcase

Curated IBEX35 + EU entity examples. FREE — does not consume quota. Use to explore data depth.

No parameters.

professional_lookup

Verify professional registrations across 24 Spanish health/legal/psychology verticals. Returns colegiado number, college, specialty, status.

Parameters (1)

querystringrequired
Professional name, colegiado number, or REPS identifier

get_full_dossier

Aggregator — 90+ fields about an entity in one call. Combines 4 ENTIA sources in parallel: identity, zone, BORME, VIES. Killer tool for due diligence/KYB.

Parameters (1)

querystringrequired
Company name, CIF/NIF, EU VAT, or LEI

get_platform_stats

Live platform stats: entities count, countries, sources, homes published.

No parameters.

run_risk_audit

Run comprehensive AI-readiness + digital risk audit on any domain. Analyzes SSL, DNS, structured data, LLM visibility. Returns risk score 0-100. 5 req/min, 30s timeout.

Parameters (3)

domainstringrequired
Domain to audit (clinicadental.es, example.com)
sector_idstring
Optional sector hint (dental, legal, talleres, …)
namestring
Optional business name for context

get_entia_home

Retrieve full Schema.org JSON-LD @graph (4 nodes: WebPage, Entity, Verification Report, Territorial Profile) for an entity's Entia Home page.

Parameters (4)

countrystringrequired
ISO 3166-1 alpha-2 (es, gb, fr)
sectorstringrequired
Industry slug (dental, legal, talleres, …)
citystringrequired
City slug (madrid, barcelona, london)
slugstringrequired
Business slug (clinica-dental-sonrisa)

lookup_by_domain

Look up a business entity by its website domain. STATUS: Coming in v1.2 — endpoint not yet deployed.

Parameters (1)

domainstringrequired
Domain name (example.com or www.example.com)

README.md5 KBView on GitHub

ENTIA MCP Server

Structured business intelligence for AI agents.

ENTIA provides verified entity data across 34 countries — accessible via Model Context Protocol (MCP) or REST API.

Metric	Value
Verified entities	5,220,360
Countries	34
BORME mercantile acts	40.3M
Healthcare professionals	570K+
MCP tools	13
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:

code

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 13-tool surface is always available via the hosted endpoint (Option 1). A published PyPI package is planned.

13 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 34 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.
`ai_ready_profile`	Full AI-ready JSON-LD profile for an entity (4-node @graph).
`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).
`lookup_by_domain`	Look up a business entity by its website domain. Roadmap: coming in v1.2.

Pricing

Free tier: 100 requests/day per IP, no signup. Authoritative pricing is published live at entia.systems/.well-known/ai-pricing.json.

Tier	Price	Requests	Overage
TRACE	Free	100/day	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

About

Built by PrecisionAI Marketing OU (Estonia, EU).

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

License

Proprietary. See Terms of Service.

Install

claude_desktop_config.json

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

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

entity_lookup

search_entities

verify_vat

zone_profile

ai_ready_profile

get_competitors

get_showcase

professional_lookup

get_full_dossier

get_platform_stats

run_risk_audit

get_entia_home

lookup_by_domain

ENTIA MCP Server

Quick Start (< 2 minutes)

Option 1: Remote MCP Server (recommended)

Option 2: REST API

Option 3: Python client (in this repo)

13 MCP Tools

Pricing

Data Sources

Links

About

License

Install