CelinaCelina
Live on Celo mainnet

Give your LLM a wallet on Celo.

Celina is an open-source Model Context Protocol server that gives LLMs read & write access to Celo mainnet — balances, stablecoins, sends, and chain reads.

Add to Cursor / Claude View on npm
$npm i @andrewkimjoseph/celina-mcp@latest
Built onCelo
claude.ai — Celina MCP
Live demoClaude using Celina to supply to and withdraw from Aave.

1-minute setup

Drop a JSON snippet into Cursor or Claude Desktop. Done.

Mainnet ready

CELO, all 15 Mento stablecoins, USDC, USDT, GoodDollar — all built in.

Keys stay local

Set CELO_PRIVATE_KEY and SELF_AGENT_PRIVATE_KEY in your MCP client env — keys never leave your machine.

§ Install

Hook Celina into your agent

Pick your client, copy the config, restart. Celina shows up as MCP tools your LLM can call.

Local stdioRecommended

Run it locally with Node

Your client spawns npx and talks to Celina over stdio. Works in any stdio client (Cursor, Claude Desktop, LM Studio, Continue, MCP Inspector). Requires Node.js ≥ 20.

  1. 01. Run npm i @andrewkimjoseph/celina-mcp@latest
  2. 02. Open your MCP config (e.g. claude_desktop_config.json, Cursor Settings → MCP) and merge the snippet below into mcpServers
  3. 03. Restart the client
{
  "mcpServers": {
    "celina-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@andrewkimjoseph/celina-mcp"],
      "env": {
        "CELO_PRIVATE_KEY": "0x...",
        "SELF_AGENT_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Keep CELO_PRIVATE_KEY and SELF_AGENT_PRIVATE_KEY out of source control — they stay on your machine.

HostedRead-only

Skip the install — point at the hosted endpoint

No Node, no npx, no keys. Use it when you only need chain reads (balances, blocks, FX quotes, GoodDollar status, governance, staking, NFTs). Write tools (send_token, Mento FX, Aave) are disabled — stick with local stdio for those.

{
  "mcpServers": {
    "celina-mcp": {
      "url": "https://mcp.usecelina.xyz/api/mcp"
    }
  }
}

Endpoint: https://mcp.usecelina.xyz/api/mcp. Never send private keys to the hosted endpoint.

§ Tools

41 tools. One agent. Whole chain.

Everything your LLM needs to read state and move value on Celo mainnet. Click any tool for the full spec.

get_network_statusread

Chain ID, latest block, gas price

get_blockread

Fetch a block by number, hash, or latest

get_latest_blocksread

Most recent blocks on Celo mainnet

get_transactionread

Transaction + receipt by hash

get_accountread

Native CELO balance, nonce, contract flag

resolve_ensread

Resolve an ENS name to a Celo or Ethereum address

get_celo_balancesread

Native CELO + ERC-20 balances

get_stablecoin_balancesread

Mento, USDC, USDT and other stables

get_token_inforead

Metadata for any ERC-20 on mainnet

estimate_sendread

Gas estimate for a CELO/ERC-20 send

send_tokenwrite

Broadcast a CELO or ERC-20 transfer

get_gooddollar_whitelisting_inforead

IdentityV4 whitelist status for a wallet

get_mento_fx_quoteread

Oracle-priced FX quote between Mento stables

estimate_mento_fxread

Gas estimate for a Mento FX swap

execute_mento_fxwrite

Send approval + Mento FX swap on mainnet

supply_aavewrite

Lend tokens to Aave V3 on Celo

withdraw_aavewrite

Redeem aTokens back to underlying

verify_self_agentread

Check if an agent is a verified human

lookup_self_agentread

Resolve a Self Agent ID by numeric ID

verify_self_requestread

Validate signed Self agent HTTP headers

register_self_agentwrite

Start Self Agent ID registration (QR flow)

check_self_registrationread

Poll a Self registration / refresh session

get_self_identityread

On-chain identity for configured Self agent

refresh_self_proofwrite

Re-run human proof after expiry

deregister_self_agentwrite

Irreversibly deregister a Self agent

sign_self_requestread

Produce x-self-agent-* headers for an HTTP call

authenticated_self_fetchwrite

HTTP fetch with Self agent auth applied

get_token_balanceread

ERC-20 balance by contract address

get_gas_fee_dataread

Current EIP-1559 gas fees on Celo

estimate_transactionread

Generic gas estimate for any tx

get_governance_proposalsread

Paginated Celo governance proposals

get_proposal_detailsread

Single proposal + CGP content

get_staking_balancesread

Staking votes by validator group

get_activatable_stakesread

Pending stakes ready to activate

get_validator_groupsread

Paginated validator groups

get_validator_group_detailsread

Single validator group details

get_total_staking_inforead

Network-wide staking totals

get_nft_inforead

NFT token info + metadata

get_nft_balanceread

ERC-721 / ERC-1155 balance

call_contract_functionread

Read-only contract call with caller ABI

estimate_contract_gasread

Gas estimate for a contract call

Ship it

Give your agent a wallet. Say hi to Celina.

Open source. MIT licensed. Built for the next wave of on-chain agents.

Install from npmLearn about MCP
Powered byCelo