entityresolver-mcp

entityresolver-mcp

MCP server for entityresolver.xyz: resolve an ambiguous name ("Apple", "ETH", "Siemens", "Stripe") into ranked candidates carrying verified canonical IDs across registries — SEC CIK + ticker, GLEIF LEI, ISIN, Wikidata QID, CoinGecko slug.

Non-US companies resolve too: a name that files nothing with the SEC still comes back with an LEI and ISIN, read back from GLEIF itself rather than recalled.

The value is the part LLMs can't do reliably: exact, cross-registry IDs, fused and confidence-ranked. No account, no API key — the paid tool settles $0.005 USDC per call over x402 on Base, signed inline by a wallet you control.

Tools

Tool	Cost	What it does
demo_resolve	free	same resolver, rate-limited per IP per day
resolve_entity	$0.005 USDC	production endpoint, paid via x402 from BUYER_PRIVATE_KEY

Setup

Works demo-only with zero config. For the paid tool, set BUYER_PRIVATE_KEY to a dedicated low-value wallet holding a little USDC on Base (payments are gasless via EIP-3009 — no ETH needed).

Claude Desktop / Claude Code (claude mcp add) / any MCP client:

{
  "mcpServers": {
    "entityresolver": {
      "command": "npx",
      "args": ["-y", "entityresolver-mcp"],
      "env": {
        "BUYER_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Omit the env block to run free-demo-only.

Key safety: use a throwaway wallet funded with cents, never a main wallet. The key stays in your local MCP config; it is only used to sign USDC transfer authorizations for this service's payments.

Env

Var	Required	Meaning
BUYER_PRIVATE_KEY	for paid tool	0x-hex key of a dedicated wallet with USDC on Base
ENTITYRESOLVER_URL	no	override service base URL (default https://entityresolver.xyz)

Example

resolve_entity("Tesla") → top candidate company "Tesla, Inc." with CIK 0001318605, ticker TSLA, LEI 54930043XZGB27CTOV49, ISIN US88160R1014, Wikidata Q478214 — fused from SEC + GLEIF + Wikidata.

resolve_entity("Siemens") → Siemens (the German conglomerate) with LEI W38RGI023J3WT1HWRP32 and ISIN DE0007236101, ranked above the identically-named SI unit and above Siemens Energy. Nothing here is in SEC EDGAR.

Links

• Service + docs: https://entityresolver.xyz
• Machine spec: https://entityresolver.xyz/llms.txt
• OpenAPI: https://entityresolver.xyz/openapi.json