Celo MCP Server

Name: Celo MCP Server
Author: celo-org

@celo-org

Repository

About Celo MCP Server

MCP server that provides AI agents with access to Celo blockchain data and functionality

#celo-mcp #blockchain #ai-agents

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "celo-mcp": {
      "command": "python",
      "args": [
        "-m",
        "celo_mcp.server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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"].