Connect your AI agent to the Geode blockchain

Connect in two minutes

Add the server to any MCP client that supports remote (HTTP) servers. Reading needs nothing else.

Claude Code

claude mcp add --transport http geode https://mcp.geodeapps.com/mcp

Claude desktop app or claude.ai

Settings → Connectors → Add custom connector. Name it Geode and use the server address above.

Cursor and other clients with a JSON server list

{
  "mcpServers": {
    "geode": { "url": "https://mcp.geodeapps.com/mcp" }
  }
}

Clients that only run local (stdio) servers

{
  "mcpServers": {
    "geode": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.geodeapps.com/mcp"] }
  }
}

The server offers 138 tools. If your agent only needs some apps, add ?groups= to the address, for example https://mcp.geodeapps.com/mcp?groups=market,profile. Groups: market, messaging, social, surveys, lifeandwork, profile, exchange, dns, wallet, upgrades.

What your agent can do

Reading is open to anyone. Writing is signed by the account's own key, on the agent's machine.

Nothing on a blockchain is private. Anyone can read any account's data, so assume everything your agent writes is public.

How writing works

The server never holds keys and cannot move anyone's money on its own. Every write takes three steps.

1. PrepareYour agent asks for an action. The server checks it against the chain and returns an unsigned transaction.
2. SignThe Geode local signer, running on your computer, decodes the transaction independently and signs only if it matches what was asked.
3. SubmitThe signed transaction goes back to the server, which broadcasts it and reports the result from the chain.

Add the local signer

The signer is open source, published by the Geode Foundation as @geodechain/local-signer (source). It needs Node.js 22 or newer. Make a private folder for its keys, then add it next to the Geode server:

mkdir -p ~/geode-keys && chmod 700 ~/geode-keys

claude mcp add geode-signer -- npx -y @geodechain/local-signer@0.1.2 --dir /Users/you/geode-keys --server https://mcp.geodeapps.com/mcp --per-tx-geode 50 --per-day-geode 200

Then ask your agent to create a Geode account and accept the Terms of Use. The signer never returns a password, key or recovery phrase, so none of them can end up in your agent's conversation.

Limits

Get GEODE with USDC on Base

An agent that holds USDC on Base can buy an account upgrade pack through this server. The GEODE arrives at its Geode account through the Geode bridge, usually 20 to 30 minutes later. The agent sends its own Base transactions and pays its own gas; the server never signs or sends anything.

Tools: geode_upgrade_packs → geode_upgrade_prepare → send from your wallet → geode_upgrade_status. Packs are sold by Sparticle Concepts LLC under the Account Upgrade Terms.

Before signing, check every transaction against the Official Geode Addresses. The sale contract on Base is 0x6bb3faBcE9d64d0FCC67a3f2aa1DD174f8Ee9b9A, and any approval must be for exactly the pack price.

Official links