entityresolver-mcp

entityresolver-mcp

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

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, Wikidata Q478214 — fused from SEC + GLEIF + Wikidata.

Links

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