Skip to content
MCP server

Celo MCP Server

Query Celo blockchain data: blocks, tokens, NFTs, contracts, governance and staking

Runs locally
Install
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.4.3
Listing updated
4 days ago

Similar MCP servers

About Celo MCP Server

Celo MCP Server is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

This Python server wraps Celo network reads in 23 tools, from blocks and transactions to token balances, NFT ownership, read-only contract calls, gas estimates, governance proposals and validator staking. It points at Celo mainnet through Forno by default and can switch to the Celo Sepolia testnet by setting an environment variable, or use a different RPC URL.

Staking tools break down active and pending stakes by validator group, list stakes ready to activate and report network-wide votes and participation. Governance tools page through proposals and show content and voting history for one. Two faucet tools exist for the testnet only: each request sends 3 CELO and they stay disabled until you set a faucet API key, which the README says is created at faucet.celo.org with a GitHub sign-in.

It starts over stdio from Cursor or Claude Desktop with uvx celo-mcp, or can run as a Streamable HTTP endpoint. The HTTP mode has settings for allowed hosts, CORS, a per-client rate limit of 60 requests a minute by default, a health check and an optional bearer token.

Install

Run in a terminal

claude mcp add celo-mcp -- uvx celo-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "celo-mcp": {
      "command": "uvx",
      "args": [
        "celo-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "celo-mcp": {
      "command": "uvx",
      "args": [
        "celo-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "celo-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "celo-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "celo-mcp": {
      "command": "uvx",
      "args": [
        "celo-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "celo-mcp": {
      "command": "uvx",
      "args": [
        "celo-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (23)

Taken from the project documentation; the running server may differ.

get_network_status
Current network status and connection information.
get_block
Block information by number, hash or latest.
get_transaction
Transaction details by hash.
get_account
Account balance and nonce.
get_latest_blocks
Recent blocks, up to 100.
get_token_info
Name, symbol, decimals and supply of a token.
get_token_balance
Token balance for an address.
get_celo_balances
CELO and stable token balances for an address.
get_nft_info
NFT metadata and collection details.
get_nft_balance
NFT balance for ERC721 and ERC1155.
call_contract_function
Call a read-only contract function.
estimate_contract_gas
Estimate gas for a contract function call.
estimate_transaction
Estimate gas and cost for a transaction.
get_gas_fee_data
Current gas fee data including EIP-1559.
get_governance_proposals
Governance proposals with pagination.
get_proposal_details
Content and voting history of a proposal.
get_staking_balances
Active and pending stakes by validator group.
get_activatable_stakes
Pending stakes that can be activated.
get_validator_groups
All validator groups with members and performance.
get_validator_group_details
Details for one validator group.
get_total_staking_info
Network-wide staking totals.
request_faucet_funds
Request testnet CELO (3 per request).
get_faucet_request_status
Check whether a queued faucet request paid out.

What it does

Chain reads
Network status, blocks, transactions and account balances.
Token and NFT tools
Token info and balances, plus ERC721 and ERC1155 ownership.
Contract calls
Call read-only functions and estimate gas for a function or transaction.
Governance
List proposals and fetch details with voting history.
Staking data
Balances by validator group, activatable stakes and validator group details.
Testnet faucet
Request 3 CELO on Sepolia with a faucet API key.

Good for

  • Check a wallet's CELO and stablecoin balances
  • Look up a transaction or block by hash
  • Review open governance proposals and how votes went
  • Compare validator groups by votes and performance
  • Estimate the gas cost of a contract call before sending

Celo MCP Server FAQ

Does it send transactions?

The listed tools read data and estimate costs. Only the testnet faucet sends funds, and only to a beneficiary address you give it.

Which network does it use?

Celo mainnet by default; set CELO_MCP_USE_TESTNET to use Celo Sepolia.

Can it run as a remote server?

Yes, with --transport http, configurable hosts, CORS, rate limiting and an optional bearer token.

What do I need for the faucet tools?

A CELO_MCP_FAUCET_API_KEY from faucet.celo.org.

How do I add Celo MCP Server to Claude Code?

Run this command in your terminal: claude mcp add celo-mcp -- uvx celo-mcp

What are the best alternatives to Celo MCP Server?

The closest alternatives to Celo MCP Server are Chia MCP, Crypto Market Data, Solana MCP by Vybe, Feegate Yield MCP - Free DeFi APY/TVL data and MCP Server.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers