celo-mcp

celo-org/celo-mcp

3.3

If you are the rightful owner of celo-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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

The Celo MCP Server is a comprehensive solution designed to facilitate seamless interaction with the Celo blockchain. It offers a wide range of functionalities, including access to blockchain data, token operations, NFT management, smart contract interactions, transaction handling, and governance operations. The server is built on the Model Context Protocol (MCP) framework and leverages Web3.py for Ethereum/Celo blockchain interactions. It supports both the Celo mainnet and the Alfajores testnet, providing users with the flexibility to work in different environments. The server is designed to be easily integrated with development environments like Cursor IDE and Claude Desktop, ensuring that developers can efficiently manage and interact with the Celo blockchain. With features like token and NFT support, smart contract interactions, transaction management, and governance support, the Celo MCP Server is an essential tool for developers working within the Celo ecosystem.

Features

  • Token Support: Full support for ERC20 tokens and Celo stable tokens, with balance queries and token information retrieval.
  • NFT Support: Multi-standard support for ERC721 and ERC1155, with automatic detection and metadata fetching.
  • Smart Contract Interactions: Function calls, gas estimation, ABI management, event handling, and transaction building.
  • Transaction Management: Accurate gas estimation, EIP-1559 support, transaction simulation, and dynamic fee calculation.
  • Governance Support: Proposal management, voting data access, metadata integration, and pagination support.

Usages

usage with Cursor IDE

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

usage with Claude Desktop

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

Tools

  1. get_network_status

    Get current network status and connection information.

  2. get_block

    Fetch block information by number, hash, or 'latest'.

  3. get_transaction

    Get transaction details by hash.

  4. get_account

    Get account information including balance and nonce.

  5. get_latest_blocks

    Get information about recent blocks.

  6. get_token_info

    Get detailed token information.

  7. get_token_balance

    Get token balance for a specific address.

  8. get_celo_balances

    Get CELO and stable token balances for an address.

  9. get_nft_info

    Get NFT information including metadata and collection details.

  10. get_nft_balance

    Get NFT balance for an address.

  11. call_contract_function

    Call a read-only contract function.

  12. estimate_contract_gas

    Estimate gas for a contract function call.

  13. estimate_transaction

    Estimate gas and cost for a transaction.

  14. get_gas_fee_data

    Get current gas fee data including EIP-1559 fees.

  15. get_governance_proposals

    Get Celo governance proposals with pagination support.

  16. get_proposal_details

    Get detailed information about a specific governance proposal.

  17. get_staking_balances

    Get staking balances for an address.

  18. get_activatable_stakes

    Get information about pending stakes that can be activated.

  19. get_validator_groups

    Get information about all validator groups.

  20. get_validator_group_details

    Get detailed information about a specific validator group.

  21. get_total_staking_info

    Get network-wide staking information.