ENTIA Entity Verification

io.github.entia-systems-corePublished by GitHub account entia-systems-corev4.4.2Updated Nov 17, 2026

Verified business identity and entity resolution for AI agents: EU VAT, BORME and GLEIF.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for verifying Spanish and EU businesses by name, CIF/NIF, EU VAT or LEI, with registry-backed search and paid due-diligence tools.

What you can do
  • Look up one company's identity, legal name, city, sector and BORME status, and validate EU VAT numbers live via VIES
  • Search and list businesses by name, keyword, country, city or sector, including a ChatGPT-style search/fetch pair
  • Read public Entia Home records as Schema.org JSON-LD and check platform coverage statistics
  • Paid tiers add postal-code socioeconomic profiles, competitor lists, domain AI-readiness and digital risk audits, and identity verification status
  • Paid tiers also add a 90+ field due-diligence dossier and Spanish health/legal professional registration checks
When to use it
Useful when an assistant needs to answer whether a company exists, who is behind a CIF/NIF, VAT or LEI, or which businesses operate in a Spanish sector and city, and when registry data is preferred over web search. Paid tools suit due diligence, KYB and market or location analysis.
Requirements
A remote MCP endpoint; no installation or local runtime is needed. Free tools work without an API key. Paid tools require a subscription plan (SIGNAL, BUILD, INTEGRATE or ENTERPRISE) and an API key; the REST API uses an X-ENTIA-Key header. Network access to the hosted endpoint is required.
Before you install
Several tools are paid subscriptions billed monthly in EUR with monthly entity quotas; calling a paid tool without a key returns an error with a checkout link. Free tools return only a trace-level preview. API access is not a data licence: AI training, dataset creation and bulk extraction need a separate licence. Professional lookup requires a GDPR data processing agreement. Integrity fields are tamper-evidence, not an electronic signature, and a registry identifier is not a VIES-confirmed VAT…

Installation

In SourceWeft

  1. Open ENTIA Entity Verification in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.entia-systems-core%2Fentity-verification/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "entia-entity-verification": {
      "type": "http",
      "url": "https://mcp.entia.systems/mcp"
    }
  }
}

README

ENTIA MCP Server

Structured business intelligence for AI agents.

ENTIA gives AI agents verified business identity data from official public registries — accessible via Model Context Protocol (MCP) or REST API.

MetricValue
Verified entities11,330,391
BORME mercantile acts40.3M
Active sources16
MCP tools15

Coverage snapshot verified on 2026-10-14; tool list and minimum plans verified against tools/list and ai-pricing.json v1.6.10 on 2026-11-02; do not assume the snapshot is updated on every registry recrawl. Query get_platform_stats for current coverage and tools/list for current tool names. An entity registry identifier is not a VIES-confirmed VAT number.

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"]    }  }}

ChatGPT — add https://mcp.entia.systems/mcp as a custom MCP connector. The search and fetch tools follow ChatGPT's connector contract and work without a key.

Then try:

Look up Telefonica in Spain

Option 2: REST API

bash
# Search entitiescurl "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 verificationcurl "https://entia.systems/v1/verify/vat/ESA28015865"
# Platform statscurl "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 15-tool surface is always available via the hosted endpoint (Option 1). A published PyPI package is planned.

15 MCP Tools

"Min plan" is the lowest plan that unlocks the tool (tier_minimum in ai-pricing.json). Calling a paid tool without a key returns HTTP 401 with the plan that unlocks it and a checkout link.

ToolMin planWhat it does
entity_lookupTRACE (free)Verify identity of any business by name, CIF/NIF, EU VAT or LEI. Cross-checks BORME, VIES, GLEIF.
search_entitiesTRACE (free)Search verified entities by name, keyword, country, city or sector.
verify_vatTRACE (free)Real-time EU VAT validation via VIES (27 member states).
get_showcaseTRACE (free)Curated IBEX35 + EU showcase entities. Does not consume quota.
get_platform_statsTRACE (free)Live platform stats: entities, sources. Does not consume quota.
get_entia_homeTRACE (free)Full Schema.org JSON-LD @graph for an entity (Entia Home).
searchTRACE (free)ChatGPT-compatible search over the ENTIA registry (wraps search_entities, free preview).
fetchTRACE (free)ChatGPT-compatible fetch of one company's free registry preview by id (wraps entity_lookup).
zone_profileSIGNALSpanish socioeconomic profile by postal code (INE/SEPE/AEAT): income, employment, business density.
run_risk_auditSIGNALAI-readiness + digital risk audit for any domain.
get_entity_home_projectionSIGNALMachine-readable projection of an Entia Home record (v1).
get_identity_verificationSIGNALFail-closed commercial identity status from the canonical Entia Home projection.
get_competitorsBUILDReal competitors in the same sector and geography.
get_full_dossierINTEGRATEAggregator: 90+ fields about an entity in one call (combines several ENTIA sources).
professional_lookupENTERPRISE (DPA)Verify professional registrations across Spanish health/legal/psychology verticals. Requires DPA (GDPR Art. 28).

Try it free (no key)

Every tool marked TRACE (free) above works without an API key. The lookup and search tools (entity_lookup, search_entities, verify_vat, search, fetch) return a trace-level preview (checked on 2026-11-02 with entity_lookup, search and verify_vat). get_showcase, get_platform_stats and get_entia_home return public data rather than a preview; get_showcase and get_platform_stats do not consume quota.

Pricing

Monthly subscription in EUR. No overage on any plan: when you reach your monthly quota, requests are paused (HTTP 429) until the next billing month. Billing unit: entity returned ("entidad consultada"), deduplicated per UTC calendar day.

PlanEUR / monthEntities / month
TRACEFree100 (preview)
EDGE9.9010,000 (edge-cached responses only)
SIGNAL29500
BUILD992,500
INTEGRATE39910,000
OPERATE1,499100,000
SCALECustom, from 2,500500,000+
ENTERPRISECustom—

Human pricing: entia.systems/pricing · Machine-readable: ai-pricing.json · /api/v1/mcp/plans

Maintainers of external MCP directories: this GitHub README and glama.json supersede older cards describing 5.5M entities / 34 countries / 20 MCP tools / per-call overage. Please refresh the existing listing and use the canonical io.github.entia-systems-core/entity-verification registry identity, rather than creating a duplicate. Publisher-side metadata is not proof that a third-party index has refreshed.

API/MCP access is not a data licence. Plans cover per-lookup grounding only. AI training, fine-tuning, dataset creation and bulk extraction require the separate ENTIA AI Training & Corpus License (ENTIA-LTC-1.0).

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.

Source: README.md at commit 3da466c

Tools

15

entity_lookup

Entity Lookup

FREE (no API key needed). Use when the user asks whether a company exists, who is behind a CIF/NIF, EU VAT or LEI, its registered legal name, city, sector or BORME (Spanish Commercial Registry) status. Look up any business entity by name, CIF/NIF, EU VAT, or LEI. Free callers receive a trace-level identity preview; authenticated callers receive the full paid dossier.

Parametersqnamequery

search_entities

Search Entities

FREE (no API key needed). Use when the user asks to find or list businesses by name, keyword, sector or city (e.g. 'dentists in Madrid', 'real estate agencies in Valencia'). Search businesses by name, keyword, country, city or sector. Results mix registry-backed companies and public business listings (local directories/maps), so not every result is registry-verified; use entity_lookup or verify_vat to verify one. Answers 'find me a dentist in Madrid' / 'list law firms in Barcelona'. `sector` is a closed vocabulary — see the enum; aliases such as `abogados` resolve to their canonical slug. Anonymous callers receive a trace-level preview (name + city); authenticated TRACE+ keys unlock full records.

Parametersqrequiredcitylimitsectorcountry

verify_vat

Verify VAT

FREE (no API key needed). Use when the user asks whether an EU VAT number is valid or active (live VIES check). Real-time EU VAT validation via VIES (27 countries). Returns {valid, name, address, vat_number, country, checked_at}. Some Member States (Spain among them) do not disclose name/address through VIES: name/address come back null with name_disclosure=withheld_by_member_state; use entity_lookup for the registered name.

Parametersqvatquery

zone_profile

Zone Profile

PAID (requires SIGNAL plan or higher, from €29/month). Use when the user asks about the income, employment, demographics, business census or real-estate profile of a Spanish postal code. Socioeconomic profile of a Spanish postal code — 17 blocks: income, employment, demographics, business census, real estate, FTTH, poverty, tourism.

Parameterspostal_coderequired

get_competitors

Get Competitors

PAID (requires BUILD plan or higher, from €99/month). Use when the user asks who competes with a business in a sector and Spanish city. Find real competitors in the same sector and city. Ranked entities with identity + location + sector matching. Spain only on the public surface. `sector` is a closed vocabulary — see the enum; aliases such as `abogados` (the slug ENTIA uses in its own Entia Home URLs) resolve to their canonical slug.

Parameterscityrequiredlimitsectorrequired

get_showcase

Get Showcase

FREE (no API key needed). Use to show example records and what ENTIA data looks like before choosing another tool. Curated IBEX35 + EU entity examples. FREE — does not consume quota. Use to explore data depth.

Parameterslimitcategory

professional_lookup

Professional Lookup

PAID (requires ENTERPRISE plan, custom contract). Use when the user asks whether a Spanish health or legal professional is registered (colegiado number, college, specialty). Verify professional registrations across 24 Spanish health/legal/psychology verticals. Returns colegiado number, college, specialty, status.

Parametersqueryrequiredvertical

get_full_dossier

Get Full Dossier

PAID (requires INTEGRATE plan or higher, from €399/month). Use for due diligence / KYB when the user wants everything about one company in a single call (identity, BORME, VIES, zone). 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.

Parametersqueryrequired

get_platform_stats

Get Platform Stats

FREE (no API key needed). Use when the user asks how much data ENTIA covers (entities, BORME acts). Live platform stats: total entities and BORME acts, counted live. Country and Entia Home counts are null (marked _unverified) until they are measured.

Takes no parameters.

run_risk_audit

Run Risk Audit

PAID (requires SIGNAL plan or higher, from €29/month). Use when the user asks about the AI-readiness, SEO/LLM visibility or digital risk of a company's website domain. 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.

Parametersnamedomainrequiredsector_id

get_entia_home

Get Entia Home

FREE (no API key needed). Use when you already have an Entia Home URL path (country/sector/city/slug) and need that public business page as data. Retrieve the Schema.org JSON-LD @graph for a specific entity's Entia Home (machine layer at /v1/identity/{country}/{sector}/{city}/{slug}.jsonld). Requires country, sector, city, slug path segments — not cif/q. Obtain the path via entity_lookup / showcase (canonical_url). Fail-closed: never returns ENTIA corporate marketing as if it were the entity.

Parameterscityrequiredslugrequiredsectorrequiredcountryrequired

get_entity_home_projection

Get Entity Home Projection v1

PAID (requires SIGNAL plan or higher, from €29/month). Use when you need the full structured projection of an Entia Home page (identity, location, verification) for one business. Read the materializer snapshot entia.entity_home_projection.v1 for an Entia Home (claims + projection + policy). Same truth as the public ficha HTML/JSON-LD twin. Serve from R2 sibling .projection.v1.json — no ad-hoc MCP enrichment.

Parameterscityrequiredslugrequiredsectorrequiredcountryrequiredinclude_render_context

fetch

FREE (no API key needed). Use after search to read one company's free registry preview by its id. Fetch one company's free registry preview by the id returned by search (or a CIF/NIF, EU VAT or LEI). Wraps entity_lookup with the free preview mask. Returns {id,title,text,url,metadata}.

Parametersidrequired

get_identity_verification

Get Identity Verification

PAID (requires SIGNAL plan or higher, from €29/month). Use when the user asks whether a business's identity has been officially verified, not just whether its CIF exists. Read fail-closed identity verification from the exact canonical HOME projection. Existing CIF does not imply official verification.

Parameterscityrequiredslugrequiredsectorrequiredcountryrequired

Version history

3
  1. v4.4.2LatestNov 17, 2026
  2. v4.4.1Oct 19, 2026
  3. v4.4.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts