convez.ai
MCP ServerIntegração & APIsIntermediário
Miracle-Alajemba

Conduit - MCP Server Celo

Miracle-Alajemba/conduit

Conecte IA ao Celo: read/write direto na blockchain em uma instalação

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server TypeScript que oferece a qualquer LLM acesso instantâneo de leitura e escrita à blockchain Celo. Integra nativamente operações como transferências de tokens, swaps via Mento, empréstimos em Aave v3, pagamentos x402 e verificação de credenciais Self Protocol — eliminando semanas de integração manual.

Instalação

$npx convez-ai Miracle-Alajemba/conduit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Agentes de IA que gerenciam carteiras e transferem tokens na rede Celo
  • Sistemas autônomos que executam swaps, empréstimos e pagamentos onchain
  • Aplicações que precisam consultar saldos, histórico de transações e status da rede em tempo real

Veredito

Solução madura e bem documentada que destranca genuinamente a interação de LLMs com Celo. UI demo integrada e 13 ferramentas prontas para produção tornam a adoção imediata. Recomendado para quem quer IA + blockchain sem overhead de integração.

README

A tradução para o português deste README ainda está na fila.

conduit

The missing infrastructure layer that connects any AI to the Celo blockchain.

npm version License: MIT Built for Celo MCP Compatible Live Demo npm downloads 8004scan

The problem

Every AI model — Claude, GPT, Gemini — has zero ability to interact with any blockchain out of the box. They can talk about crypto but cannot touch it. Meanwhile, developers who want to build AI agents on Celo have to manually integrate viem, Mento, Aave, and Self Protocol separately — weeks of work before writing a single line of agent logic.

conduit solves both problems in one package.

What it does

conduit is a TypeScript MCP server that gives any LLM instant read and write access to the Celo blockchain. Connect Claude, GPT, or any MCP-compatible AI to Celo — check balances, send tokens, swap via Mento, lend on Aave v3, make x402 payments, and verify Self Protocol credentials, all from a single chat session.

🌐 Live site: https://useconduit.vercel.app

One installation. One config. Full Celo access.

Demo

conduit demo

Try it live locally:

# Clone and install
git clone https://github.com/Miracle-Alajemba/conduit
cd conduit
npm install
npm run build

# Start the demo UI
npm run demo

Then open http://localhost:3000 in your browser to see all 13 tools running live.

Tools (13 total)

ToolTypeDescription
pingReadTest connectivity and get current Celo block number
get_balanceReadCheck CELO, USDC, cUSD, cKES, cEUR balances for any address
get_transactionsReadFetch and classify recent wallet transactions
get_token_priceReadLive token prices in USD via CoinGecko
send_tokensWriteSend CELO or any ERC-20 to an address
swap_tokensWriteSwap tokens via Mento protocol
x402_payWriteMake stablecoin payments to x402-enabled endpoints
lend_on_aaveWriteDeposit tokens to Aave v3 on Celo to earn yield
withdraw_from_aaveWriteWithdraw from your Aave v3 position
get_aave_positionsReadCheck active Aave v3 positions (deposits, debt, health factor)
self_verifyReadVerify a wallet's Self Protocol credential
check_agent_idReadLook up and verify a Self Agent ID
get_network_statusReadCheck Celo network health and current gas price

Interactive Demo UI

conduit ships with a built in web UI for testing and demoing all 13 tools directly from your browser. No Claude Desktop or MCP Inspector needed.

Features:

  • Live Celo network connection status at the bottom of the page
  • All 13 tools displayed as interactive cards
  • Read tools return live onchain data instantly
  • Write tools default to dry run mode — safe to test without real funds
  • One click copy for the npm install command
  • Direct links to GitHub, npm, and agentscan

To start the demo UI:

npm run demo

Then open http://localhost:3000

Why conduit matters for Celo

  • Expands the developer base — AI developers who don't know Web3 can now build on Celo without learning blockchain development
  • Every tool call = a real transaction — drives genuine onchain activity across the Celo ecosystem
  • Foundation for every other agent — savings agents, remittance tools, DeFi bots, all built faster on top of conduit
  • Sybil resistance built in — Self Protocol integration means any agent using conduit can verify real humans from day one
  • Serves MiniPay's 15M users — AI agents built on conduit can reach real users in Nigeria, Kenya, and Ghana immediately

Prerequisites

  • Node.js 18+
  • A Celo wallet private key
  • Self Protocol API key (optional, for self_verify and check_agent_id)

Installation

Option 1: Install from npm

npm install -g conduit-celo

Option 2: Clone and build

git clone https://github.com/Miracle-Alajemba/conduit
cd conduit
npm install
npm run build

Option 3: Run the demo UI

git clone https://github.com/Miracle-Alajemba/conduit
cd conduit
npm install
npm run build
npm run demo

Open http://localhost:3000 to interact with all 13 tools from a browser UI.

Configuration

Copy .env.example to .env and fill in your values:

cp .env.example .env
# ─── RPC Configuration ───────────────────────────────────────────
# Development (free, may rate limit under heavy agent volume)
CELO_RPC_URL=https://forno.celo.org

# Production (recommended for high volume agents)
# Get a free dedicated Celo endpoint at https://chainstack.com
# CELO_RPC_URL=https://your-chainstack-endpoint-here

# ─── Wallet Configuration ────────────────────────────────────────
PRIVATE_KEY=your_wallet_private_key_here
WALLET_ADDRESS=your_wallet_address_here

# ─── API Keys ────────────────────────────────────────────────────
CELO_EXPLORER_API=https://explorer.celo.org/mainnet/api
SELF_API_KEY=your_self_protocol_api_key

Note: For production agents handling high transaction volume, we recommend using a dedicated RPC endpoint via Chainstack instead of the public Forno endpoint which may rate limit under heavy load.

Claude Desktop Setup

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "conduit": {
      "command": "npx",
      "args": ["conduit-celo"],
      "env": {
        "CELO_RPC_URL": "https://forno.celo.org",
        "PRIVATE_KEY": "your_private_key_here",
        "WALLET_ADDRESS": "your_wallet_address_here",
        "SELF_API_KEY": "your_self_api_key_here"
      }
    }
  }
}

Claude Desktop config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Safety first

All write tools (send_tokens, swap_tokens, x402_pay, lend_on_aave, withdraw_from_aave) default to dryRun: true. No real transaction is sent unless you explicitly pass dryRun: false. Every write tool simulates first and shows you exactly what will happen before touching real funds.

Built with

Roadmap

  • Add Ubeswap integration for deeper liquidity
  • Multi-wallet support
  • Natural language transaction summaries
  • MiniPay deep integration
  • Agent-to-agent payment flows via x402

Scripts

CommandDescription
npm run buildCompile TypeScript to JavaScript
npm startStart the MCP server (for Claude Desktop / MCP clients)
npm run demoStart the browser demo UI at http://localhost:3000

Links

Contributing

PRs welcome. Open an issue first to discuss what you'd like to change.

License

MIT — built with ❤️ for the Celo ecosystem

Ver o original no GitHub

Bom para

Relacionados