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 分