# Celo MCP Server

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: celo-org
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/celo-org/celo-mcp
- Updated: 2026-10-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/celo-mcp-server

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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>

### Codex

**Platform CLI**
```bash
codex mcp add celo-mcp-server -- uvx celo-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from celo-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "celo-mcp-server": {
            "command": "uvx",
            "args": [
                "celo-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from celo-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "celo-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "celo-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from celo-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add celo-mcp-server uvx celo-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from celo-mcp <command>

## When to use it
- 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
- 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.

## Similar
- [celopedia-skill](https://affpapa.org/en/nevibecode/skills/celopedia-skill.md) — skill · ★ 31 repo stars
- [Everstake](https://affpapa.org/en/nevibecode/mcp/everstake.md) — MCP server · 231 installs
- [DeFi Yield Finder — Best APY Across 100+ Protocols](https://affpapa.org/en/nevibecode/mcp/defi-yield-finder-best-apy-across-100-protocols.md) — MCP server · 3729 installs
- [signomy](https://affpapa.org/en/nevibecode/mcp/signomy.md) — MCP server · 2104 installs
- [Solentic](https://affpapa.org/en/nevibecode/mcp/solentic.md) — MCP server · 1402 installs
- [defi-protocol-templates](https://affpapa.org/en/nevibecode/skills/defi-protocol-templates.md) — skill · 10400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
