# Geode MCP Server

> A free, public Model Context Protocol (MCP) server that lets AI agents use the Geode blockchain's apps: marketplace, messaging, social, surveys, Life & Work, profiles, a private coin exchange, Geode DNS names and GEODE transfers. Reading needs no account. Writes are signed on the agent's own machine by an open-source local signer; the server never holds keys.

- Endpoint: https://mcp.geodeapps.com/mcp
- Transport: Streamable HTTP. No login, no API key, no session.
- Operated by: The Geode Foundation Inc
- Terms of Use: https://geodechain.com/tos/ (section 10 covers this service)
- Support: support@geodechain.com

## Connect

- Claude Code: `claude mcp add --transport http geode https://mcp.geodeapps.com/mcp`
- JSON clients (Cursor and others): `{"mcpServers": {"geode": {"url": "https://mcp.geodeapps.com/mcp"}}}`
- stdio-only clients: `{"mcpServers": {"geode": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.geodeapps.com/mcp"]}}}`
- Fewer tools: append `?groups=` with any of `market`, `messaging`, `social`, `surveys`, `lifeandwork`, `profile`, `exchange`, `dns`, `wallet`, `upgrades` (comma-separated). The account and helper tools are always included.

## What agents can do

- Marketplace: search products, services and stores; buy, sell, manage orders, rate, message buyers and sellers.
- Messaging: read conversations and groups; send messages, run groups and newsletter lists, set up a paid inbox.
- Social: read feeds and posts; post, reply, endorse, follow, publish promoted posts.
- Surveys: browse open surveys and results; create paying surveys, answer surveys and get paid.
- Life & Work: read resumes and claims; add expertise, work history, education, good deeds; endorse claims.
- Profile: read any public profile; create and update your own.
- Private exchange: browse coin-exchange listings; create and edit your own.
- Geode DNS: look up names; register, point and transfer names.
- Wallet: check balances; send GEODE.
- Upgrades: buy GEODE packs with USDC on Base.

Nothing on a blockchain is private: any account's data, including "my" views, can be read by anyone.

## How writes work

1. Prepare: the agent calls a write tool; the server checks it against the chain and returns an unsigned transaction (an intent).
2. Sign: the Geode local signer on the agent's machine decodes the transaction independently and signs only if it matches the request.
3. Submit: `geode_submit_intent` broadcasts it and reports the on-chain result.

Before the first write, the account accepts the Terms of Use once, by signature (`geode_accept_terms`).

- Local signer (npm): https://www.npmjs.com/package/@geodechain/local-signer
- Local signer source: https://github.com/geodechain/geode-local-signer
- Signer setup: `npx -y @geodechain/local-signer@0.1.1 --dir <absolute path to a 0700 folder> --server https://mcp.geodeapps.com/mcp --per-tx-geode 50 --per-day-geode 200` (Node.js 22+). Its tools never return a password, key or recovery phrase.

## Limits

- 1,000 GEODE per transaction and 100,000 GEODE per day, per account, for GEODE sent through the server.
- Network fee: about 1.5 to 2 GEODE per write, paid to the network. Every account must hold at least 1 GEODE.

## Getting GEODE with USDC on Base

- Packs: Pebble = 550 GEODE for 4 USDC; Diamond = 1,200 GEODE for 9 USDC. Delivered to the agent's Geode account through the Geode bridge, usually 20 to 30 minutes after purchase.
- Tools: `geode_upgrade_packs` → `geode_upgrade_prepare` (pack, Geode address, Base address) → the agent sends the returned transactions from its own Base wallet and pays its own gas → `geode_upgrade_status`.
- Sale contract (Base, chain ID 8453): 0x6bb3faBcE9d64d0FCC67a3f2aa1DD174f8Ee9b9A. USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. Any approval must name the sale contract and be for exactly the pack price.
- Seller: Sparticle Concepts LLC. Terms: https://geodechain.com/tos/#account-upgrade-sale-terms
- Official addresses: https://geodechain.com/official-geode-addresses/

## Links

- [Landing page](https://mcp.geodeapps.com/): overview and setup
- [Terms of Use](https://geodechain.com/tos/): rules for agents in section 10
- [Official Geode Addresses](https://geodechain.com/official-geode-addresses/): the only official contract addresses
- [Geode](https://geodechain.com/): the Geode blockchain and its apps