Celo MCP Server

What is Celo MCP Server?

A Model Context Protocol (MCP) server for interacting with the Celo blockchain. It provides comprehensive access to blockchain data, token operations, NFT management, smart contract interactions, transaction handling, and governance operations.

How to use Celo MCP Server?

Install via pip install -e . (or pip install celo-mcp from PyPI) and optionally set CELO_RPC_URL or CELO_TESTNET_RPC_URL. Run with python -m celo_mcp.server or celo-mcp-server. To integrate with Cursor IDE or Claude Desktop, add a JSON configuration entry pointing to uvx --refresh celo-mcp.

Key features of Celo MCP Server

• Get network status, block, transaction, and account data
• Query ERC20 token information and balances
• Fetch CELO and stable token balances (cUSD, cEUR, cREAL)
• Read NFT data for ERC721 and ERC1155 with IPFS support
• Call read-only smart contract functions and estimate gas
• Retrieve Celo governance proposals with voting details

Use cases of Celo MCP Server

• Build a chatbot that answers questions about the Celo blockchain
• Automate monitoring of token balances and NFT holdings
• Analyze governance proposals and voting history
• Estimate transaction costs and gas fees before sending
• Integrate Celo data into AI assistants via MCP

FAQ from Celo MCP Server

What RPC URLs does the server use?

It defaults to Celo mainnet (https://forno.celo.org) and Alfajores testnet (https://alfajores-forno.celo-testnet.org). These can be overridden with environment variables.

Which token and NFT standards are supported?

ERC20, Celo stable tokens (cUSD, cEUR, cREAL), ERC721, and ERC1155 are supported. The server automatically detects NFT standards using ERC165.

How do I integrate with Cursor or Claude Desktop?

Add a configuration entry to ~/.cursor/mcp.json or ~/Library/Application Support/Claude/claude_desktop_config.json with command uvx and args ["--refresh", "celo-mcp"].

What is the MCP framework?

The server is built on the Model Context Protocol (MCP), designed for AI assistants to access external tools and data.

Does it support IPFS for NFT metadata?

Yes, it has built-in IPFS gateway support to retrieve and parse NFT metadata from IPFS URIs.