ENTIA Entity Verification

io.github.entia-systems-core由 GitHub 账号 entia-systems-core 发布v4.4.2更新于 Nov 17, 2026

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

已验证Streamable HTTP可网页运行金融数据与分析商业与电商

概览

AI 生成的概览

远程 MCP 服务器,可按名称、CIF/NIF、欧盟增值税号或 LEI 核验西班牙及欧盟企业,并提供基于官方登记库的搜索与付费尽职调查工具。

可以做什么
  • 查询单个企业的身份、法定名称、城市、行业与 BORME 状态,并通过 VIES 实时校验欧盟增值税号
  • 按名称、关键词、国家、城市或行业搜索并列出企业,另含 ChatGPT 风格的 search/fetch 组合
  • 以 Schema.org JSON-LD 读取公开的 Entia Home 记录,并查看平台覆盖统计
  • 付费档位提供邮编社会经济画像、竞争对手列表、域名 AI 就绪度与数字风险审计,以及身份核验状态
  • 付费档位还提供 90 多个字段的尽职调查档案,以及西班牙医疗与法律专业人士注册查询
适用场景
适合需要回答某公司是否存在、CIF/NIF、增值税号或 LEI 背后是谁,或某西班牙行业与城市有哪些企业,并希望以官方登记数据替代网页搜索的场景。付费工具适用于尽职调查、KYB 以及市场或区位分析。
运行要求
需要远程 MCP 端点,无需安装或本地运行时。免费工具无需 API 密钥。付费工具需订阅档位(SIGNAL、BUILD、INTEGRATE 或 ENTERPRISE)及 API 密钥;REST API 使用 X-ENTIA-Key 请求头。需能访问托管端点。
安装前请注意
多个工具为按月计费的欧元订阅,设有每月实体配额;无密钥调用付费工具会返回错误及结账链接。免费工具仅返回 trace 级预览。API 访问不等于数据许可:AI 训练、数据集构建与批量抓取需另行取得许可。专业人士查询需签署 GDPR 数据处理协议。完整性字段仅为防篡改证据,并非电子签名;登记标识也不等于经 VIES 确认的增值税号。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ENTIA Entity Verification,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.entia-systems-core%2Fentity-verification/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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.

来源:README.md,提交 3da466c

工具

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.

输入参数qnamequery

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.

输入参数q必填citylimitsectorcountry

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.

输入参数qvatquery

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.

输入参数postal_code必填

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.

输入参数city必填limitsector必填

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.

输入参数limitcategory

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.

输入参数query必填vertical

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.

输入参数query必填

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.

无需输入参数。

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.

输入参数namedomain必填sector_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.

输入参数city必填slug必填sector必填country必填

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.

输入参数city必填slug必填sector必填country必填include_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}.

输入参数id必填

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.

输入参数city必填slug必填sector必填country必填

版本历史

3
  1. v4.4.2最新Nov 17, 2026
  2. v4.4.1Oct 19, 2026
  3. v4.4.0Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分