# Celo MCP Server

> Celo MCP Server is an MCP server for finance and payments. Query Celo blockchain data: blocks, tokens, NFTs, contracts, governance and staking. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/celo-org/celo-mcp
- **MCP Registry name:** org.celo/celo-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add celo-mcp -- uvx celo-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Chia MCP](https://ai-powered.com/mcp/chia-mcp): Chia MCP is an open-source MCP server for finance and payments.
- [Crypto Market Data](https://ai-powered.com/mcp/crypto-market-data): Crypto Market Data is an open-source MCP server for finance and payments.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Feegate Yield MCP - Free DeFi APY/TVL data](https://ai-powered.com/mcp/feegate-yield-mcp-free-defi-apy-tvl-data): Feegate Yield MCP - Free DeFi APY/TVL data is an open-source MCP server for finance and payments.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mweo0fxz): MCP Server is a freemium MCP server for finance and payments.
- [Solana Nft MCP](https://ai-powered.com/mcp/solana-nft-mcp): Solana Nft MCP is an open-source MCP server for finance and payments.
- [SoChain](https://ai-powered.com/mcp/sochain): SoChain is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/celo-mcp-server
