Developers // LIVE CONTRACT

Build on the
economic identity graph.

ENTIA turns governed observations into canonical economic identity. One graph; multiple machine-ready projections for agents, applications, grounding and evidence-driven workflows.

Live platform state

runtime

Registry corpus figures are loaded from GET /api/v1/stats/live. Entia Home launch scope is a separate product-generation metric derived from the canonical generator matrix.

—
Canonical entities
—
Published corpus countries
—
Active sources
51
Entia Home launch countries
—
BORME acts
57
Countries configured in generator matrix

Corpus source: get_platform_stats · Home scope source: scripts/nodealpha/country_matrix.json → home_launch_countries · loading…

Do not collapse these metrics. The published registry corpus currently reports its own country coverage live. Entia Home generation is configured for 51 launch countries (38 Europe + 13 LatAm) inside a broader 57-country generator matrix. Upstream scraping, creation jobs and publisher scope are operational stages, not substitutes for either metric.

One graph. Multiple projections.

ENTIA is not a static dataset or directory. Observations are resolved into governed claims on a canonical economic-identity graph, then projected for different machine-consumption paths.

01 · ObserveOfficial registries, public records and governed source observations.
02 · ResolveNames, domains, VAT, LEI and registry identifiers converge on one entity.
03 · GovernClaims carry evidence, provenance, observation time, source rights and assurance.
04 · ProjectEntia Home, JSON-LD, REST, MCP and grounding expose controlled views.
05 · UpdateDeltas, corrections and new evidence continuously modify the graph.

Choose your interface

MCP · AGENTS

Native tools for AI systems

Streamable HTTP at https://mcp.entia.systems/mcp. tools/list is authoritative for the current schema.

POST https://mcp.entia.systems/mcp Accept: application/json, text/event-stream Content-Type: application/json x-entia-key: <KEY> {"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}

REST v3 · APPLICATIONS

Same capabilities over HTTP

Customer integrations use /api/v1/v3/*. Historical internal paths are not the customer contract.

GET https://api.entia.systems/api/v1/v3/entity_lookup?query=A28015865 x-entia-key: <KEY> GET https://api.entia.systems/api/v1/stats/live # public, no auth

Capability matrix

Current MCP inventory: 12 tools. Runtime tools/list remains authoritative.

CapabilityMCP toolHTTP surfaceAccess
Entity resolutionentity_lookup/api/v1/v3/entity_lookupPublic preview / key
Entity searchsearch_entities/api/v1/v3/search_entitiesPublic preview / key
VAT validationverify_vat/api/v1/v3/verify_vatPublic preview / key
Territorial contextzone_profile/api/v1/v3/zone_profileSIGNAL+
Competitor contextget_competitors/api/v1/v3/get_competitorsBUILD+
Curated examplesget_showcase/api/v1/v3/get_showcasePublic
Professional registryprofessional_lookup/api/v1/v3/professional_lookupEnterprise + DPA
Full dossierget_full_dossier/api/v1/v3/full_dossierINTEGRATE+
Platform stateget_platform_stats/api/v1/stats/livePublic
Risk auditrun_risk_audit/api/v1/v3/run_risk_auditSIGNAL+
Entia Home JSON-LDget_entia_home/v1/identity/{cc}/{sector}/{city}/{slug}.jsonldPublic
Home projection snapshotget_entity_home_projectionProjection contractSIGNAL+

Entity resolution

Resolution is the core operation: multiple identifiers and observations converge on a canonical entity before downstream projections are produced.

INPUTS

Company name · VAT / CIF / NIF · LEI · domain · canonical URL · country · national registry identifier.

OUTPUT

Canonical entity · identifiers · corroborating sources · verification state · provenance · territorial context · machine projections.

Evidence, provenance & assurance

A claim is more useful than a generic “verified” label when its origin and observation context travel with it.

{ "value": "...", "source": "...", "observed_at": "...", "verification_method": "...", "assurance": "...", "provenance": [...] }
Exact response fields depend on the capability and schema version. Use tools/list, the REST reference and machine-readable manifests as the contract; do not infer fields from this illustrative shape.

Authentication & operational contract

CUSTOMER AUTH

x-entia-key: <KEY>

HTTP header names are case-insensitive. X-ENTIA-API-KEY is a different internal header and is not the customer credential.

MACHINE CONTRACTS

/.well-known/api-catalog
/.well-known/mcp.json
/.well-known/ai-pricing.json
/.well-known/entia-home-scope.json
tools/list

Billing webhooks. Stripe webhook signature verification is an internal billing control. ENTIA does not currently document customer-facing outbound webhooks as a product surface.

Operational semantics

MEASUREMENT BOUNDARY

Machine access ≠ retrieval ≠ citation ≠ answer inclusion ≠ commercial action. Each event needs its own evidence. Crawling or access does not demonstrate model training.

EVIDENTIAL BOUNDARY

An ordinary API response is not by itself an electronic seal or qualified timestamp. Separate forensic workflows may archive and timestamp evidential records under their own chain-of-custody process.

Start building

Agents

Connect through MCP and let the client discover the live tool schema.

MCP setup →

Applications

Use the REST v3 surface with x-entia-key and the same canonical capabilities.

API reference →