RegistryChain MCP Server

MCP (Model Context Protocol) server for RegistryChain — lets AI agents list, inspect, and register on-chain entities through a Streamable HTTP transport with OAuth 2.0 + Privy authentication.

How It Works

1Cursor / Claude               RegistryChain MCP                    Gateway
─────────────────         ──────────────────────────         ─────────────────
1. Add MCP URL   ──────▶  OAuth discovery (.well-known)
2. Open browser  ──────▶  /authorize → /auth/login
3. Login (Privy)          Verify token (Privy server SDK)
4. Get token     ◀──────  Access token (wallet inside)
5. Call tools    ──────▶  Bearer token → tool handler  ──────▶  Resolver API
6. See results   ◀──────  Personalized response        ◀──────  Entity data

When you add this server to Cursor or Claude, it opens a browser window where you log in via Privy (wallet, email, Google, GitHub, Apple). After that, every tool call knows your wallet address — list_entities shows your entities by default, get_entity tells you if you're the owner, and register_entity pre-fills your wallet.

Adding to Claude Desktop

Remote MCP servers are added through the Claude UI as custom connectors, not via claude_desktop_config.json (that file only supports local stdio servers).

Open Claude Desktop → click the "+" button at the bottom-left of the chat → Connectors
Click "+" → "Add custom connector"
Enter the server URL:

1https://mcp.registrychain.com/mcp

Click Add. Claude will open your browser for the Privy login flow.
Once authenticated, enable the connector for any conversation via the "+" → Connectors menu.

Note: Remote MCP connections in Claude Desktop are brokered through Anthropic's cloud. The claude_desktop_config.json file is only for local command-based servers.

Adding to Cursor

Open Cursor → Settings (Cmd/Ctrl + ,) → search for MCP
Click Add new MCP server and enter:

Name: registrychain
Type: HTTP
URL: https://mcp.registrychain.com/mcp

Or edit .cursor/mcp.json in your project root directly:

1{
"mcpServers": {
  "registrychain": {
    "url": "https://mcp.registrychain.com/mcp"
  }
}
7}

Cursor will detect the OAuth requirement automatically. On first use, it opens your browser for Privy login.
After logging in, all RegistryChain tools are available in Cursor's agent mode.

Available Tools

Tool	Description
`list_entities`	List entities with filtering, sorting, pagination. Auto-filters by your wallet when no address is given.
`get_entity`	Look up an entity by entity ID or nodehash. Includes `_isOwner` flag for your wallet.
`register_entity`	Register a new entity. Checks entity ID availability, returns a signing URL. Pre-fills your wallet as owner.
`check_entity_id`	Check if an entity ID is available, with alternatives if taken.