Skip to main content
MCP server CX Codex

Celo MCP Server — Claude Code MCP server: features and setup

Connect an AI agent to Celo blockchain data, from blocks and token balances to governance and staking. Useful when you want to inspect the network through an agent.

no license ★ 5 updated 2026-10-27

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add celo-mcp -- uvx celo-mcp
Open on GitHub

What Celo MCP Server does

The server gives an agent tools for reading Celo network, token, and NFT data. Ask about a block, transaction, or account; check fees; call a read-only smart contract function; or estimate the gas for a contract call.

Governance and staking tools cover proposals, voting history, account stakes, and validator groups. To use Celo Sepolia, set CELO_MCP_USE_TESTNET=true; choose an RPC endpoint with CELO_MCP_RPC_URL. For the Claude Code setup, the install command runs the server through uvx.

The default network is Celo mainnet. Faucet tools are limited to testnet and need CELO_MCP_FAUCET_API_KEY; they stay disabled without it. An HTTP transport is available for remote clients, but that setup requires configuring access to the server endpoint.

What it helps with

  • check network status and inspect recent blocks
  • look up CELO and token balances for an address
  • retrieve NFT metadata and collection balances
  • estimate transaction fees and gas costs
  • review governance proposals and validator stakes

Example prompts for the agent

  • Check Celo network status and show the latest blocks.
  • Look up CELO and token balances for this address.
  • Find active and pending stakes for this address.

How to install Celo MCP Server

Platform CLI

claude mcp add celo-mcp -- uvx celo-mcp

uvx runs the command named after the package; if the README names another one, use uvx --from celo-mcp <command>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Celo MCP Server

How do I install Celo MCP Server in Claude Code?

Run claude mcp add celo-mcp -- uvx celo-mcp. This registers the server under the name celo-mcp.

What does Celo MCP Server do?

It gives an agent tools to inspect Celo blocks, transactions, accounts, tokens, NFTs, and smart contracts. Other tools cover governance proposals and staking.

How do I connect it to Celo Sepolia?

Set CELO_MCP_USE_TESTNET=true in the environment. To choose an RPC endpoint, set CELO_MCP_RPC_URL.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open