MCP Integration

The @etherean/mcp package is an MCP (Model Context Protocol) server that reads an Etherean's soul from chain and serves it as context to any compatible AI.

Quick Start

# Talk to a specific Etherean
npx @etherean/mcp --id 1

# Talk to the collective (Etherean #0)
npx @etherean/mcp --id 0

This starts a local MCP server that any MCP-compatible AI can connect to. The soul.md is fetched from the onchain contract and served as system context.

What the Server Provides

• Soul document — the full soul.md as system prompt context
• Etherean metadata — handle, palette, mint date, token ID
• Chain state — current block number, gas price (from public RPC)
• TBA inventory — what the Etherean owns (ETH, tokens, NFTs)

Compatible Tools

Any AI tool that supports MCP can use an Etherean's soul:

• Claude Code — add to your MCP config
• Cursor — add as an MCP server in settings
• Any MCP client — standard protocol, no vendor lock-in

Configuration

Add to your MCP settings (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "etherean": {
      "command": "npx",
      "args": ["@etherean/mcp", "--id", "1"]
    }
  }
}

How It Reads the Soul

1. Resolves the Etherean's TBA address from the 6551 registry
2. Reads the soul NFT's content(tokenId) from the Soul contract
3. Fetches current chain state via public RPC
4. Serves everything as MCP context to the connected AI

No API keys needed. No backend. The soul is read directly from Ethereum mainnet.

Status

The MCP package is in development. Until it ships, use the system prompt approach as an immediate alternative.