# Celo MCP Server

Source: https://docs.celo.org/build/mcp/celo-mcp
Kiwi News: https://news.kiwistand.com/stories/Celo-MCP-Server?index=0x68779649cde7e8cc21d08ae76b711e03229eadb95be5d252248927bc32c9b33340f5f57d
Submitted by @ccarella on 2025-07-16 UTC, 3 upvotes, 0 comments

## Summary

The Celo MCP Server gives AI assistants and editors read-only access to Celo blockchain data, including blocks, transactions, token balances, gas fees, governance proposals, and staking and validator information. It runs locally over stdio or as a remote endpoint over Streamable HTTP. Every tool is a query, and the server never signs or sends transactions, so it cannot move funds. Supported clients include VS Code, Cursor, Claude Desktop, Claude Code, Windsurf and JetBrains IDEs, and it requires Python 3.11 or higher.

## Article

The Celo MCP Server gives AI assistants and editors read access to Celo — blocks, transactions, token balances, gas fees, governance proposals, staking and validator data. It runs locally over stdio, or as a remote endpoint over Streamable HTTP. Every tool is a query. The server never signs or sends a transaction, so it cannot move funds. To give an agent a wallet, see Celina.

What it covers

Network status, blocks and transactions

CELO, ERC-20 and Mento stablecoin balances for any address

EIP-1559 gas fee data

Governance proposals and proposal details

Staking balances, activatable stakes, validator groups and network-wide staking metrics

Prerequisites

Python 3.11 or higher

An MCP-capable client — VS Code, Cursor, Claude Desktop, Claude Code, Windsurf or a JetBrains IDE

Install

uvx celo-mcp also works and needs no install step; the client configurations below use it.

Connect your client

VS Code

Cursor

Claude Desktop

Claude Code

Windsurf & JetBrains

VS Code reads .vscode/mcp.json in your workspace, or the user-level file opened with MCP: Open User Configuration from the command palette. The key is servers, not mcpServers:

Add to ~/.cursor/mcp.json:

--refresh makes uvx re-resolve the package so you pick up new releases.

Add to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows:

Both configure MCP servers through their own settings UI rather than a file you edit directly. Use uvx as the command and --refresh celo-mcp as the arguments.

Try it:

Network and blocks

get_network_status — current network status and connection information

get_block — a block by number, hash, or latest

get_latest_blocks — recent blocks; count defaults to 10 (max 100) and offset skips that many blocks back from the head

get_transaction — transaction detail by hash

Balances and fees

get_celo_balances — CELO plus the core Mento stablecoins for an address; symbols are read from each contract on chain, so they come back as USDm, EURm and BRLm

get_stable_token_balance — a wider set of tokens in one multicall: CELO, the Mento stablecoins, and USDC, USDT, USDGLO, cKES and others; symbols come from the server’s built-in token table, so the same three stablecoins are reported as cUSD, cEUR and cREAL

get_token_balance — the balance of one specific token for an address

get_gas_fee_data — current gas fees, including EIP-1559 fields

Governance

get_governance_proposals — governance proposals, paginated; page_size defaults to 10 (max 20)

get_proposal_details — detail for one proposal

Staking and validators

get_staking_balances — staking balances for an address, by validator group

get_activatable_stakes — pending stakes that can be activated for rewards

get_total_staking_info — network-wide staking and participation metrics

get_validator_groups — validator groups with members, votes, capacity and performance. Paginated, page_size defaults to 10, so a single call is not the full set

get_validator_group_details — detail for one validator group

Run as a remote HTTP endpoint

Running the server over Streamable HTTP lets clients connect with a single URL and no local Python install. This is server operation — if you only want the server on your own machine, the stdio configurations above are all you need.

MCP_TRANSPORT, HOST and PORT set the same three values from the environment.

GET /health returns 200 for hosting health checks. Point a remote-capable client at the URL. The type field is required — an entry with a url and no type is read as a stdio server and silently skipped:

Claude Code

VS Code

Cursor

Claude Desktop

With MCP_AUTH_TOKEN set on the server:

Drop headers if the server has no MCP_AUTH_TOKEN.

Remote servers are added as custom connectors rather than through a config file: Settings → Connectors → Add custom connector, then paste the URL.Claude connects from Anthropic’s infrastructure, not your machine, so the endpoint has to be reachable on the public internet.

Development

Resources

What is MCP? - how the protocol works and which Celo servers exist

Celo Docs MCP Server - search these docs from your editor

Celina - an agent wallet, for the write side

Network information - chain IDs, RPC URLs and explorers