Celo MCP Server
About
MCP server that provides AI agents with access to Celo blockchain data and functionality
Details
- Author
- celo-org
- Downloads
- 268
- Categories
- Other, AI
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Celo MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"celo mcp server": {
"celo-mcp": {
"command": "python",
"args": [
"-m",
"celo_mcp.server"
]
}
}
}
}McpServers
{
"celo-mcp": {
"command": "python",
"args": [
"-m",
"celo_mcp.server"
]
}
}Celo MCP Server
A Model Context Protocol (MCP) server for interacting with the Celo blockchain. This server provides comprehensive access to Celo blockchain data, token operations, NFT management, smart contract interactions, transaction handling, and governance operations.
Installation
1. Clone the repository:
git clone https://github.com/celo-org/celo-mcp
cd celo-mcp
2. Install dependencies:
pip install -e .
3. Set up environment variables (optional):
export CELO_RPC_URL="https://forno.celo.org" # Default: Celo mainnet
export CELO_TESTNET_RPC_URL="https://alfajores-forno.celo-testnet.org" # Alfajores testnet
MCP Integration
Cursor IDE Integration
To use this MCP server with Cursor IDE, add the following configuration to your MCP settings file (~/.cursor/mcp.json):
{
"mcpServers": {
"celo-mcp": {
"command": "uvx",
"args": ["--refresh", "celo-mcp"]
}
}
}
The --refresh flag ensures that the latest code is always loaded when the MCP server starts.
Claude Desktop Integration
For Claude Desktop, add this configuration to your MCP settings file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"celo-mcp": {
"command": "uvx",
"args": ["--refresh", "celo-mcp"]
}
}
}
Usage
Running the Server
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
