Cardano-mcp
lidonation/Cardano-mcp
Cardano's missing MCP server. Query UTxOs, decode datums, scaffold Aiken validators, watch addresses with Kupo, and query live CIP-1694 governance — all from your AI agent
Instalação
npx convez-ai lidonation/Cardano-mcp1 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
README
A tradução para o português deste README ainda está na fila.
The Cardano stack, native to your AI agent.
A production-grade MCP server giving Claude deep, idiomatic access to Cardano — UTxOs, native assets, smart contracts, indexers, and full CIP-1694 governance — without leaving your editor.
Why
Solana has 40+ MCPs. EVM has 30+. Cardano had nothing dedicated.
Cardano's eUTxO model is fundamentally different from Ethereum's account model — no balances, only UTxOs; smart contracts are validators not code runners; datums carry state not contracts; amounts are always in lovelace. Generic blockchain MCPs get this wrong. This one is purpose-built.
Quick start
git clone https://github.com/lidonation/Cardano-mcp
cd Cardano-mcp
pnpm install && pnpm build
Copy .env.example to .env and add your Blockfrost project ID:
BLOCKFROST_PROJECT_ID=mainnetXXXXXXXXXXXXXX
CARDANO_NETWORK=mainnet
Claude Desktop
{
"mcpServers": {
"cardano": {
"command": "node",
"args": ["/absolute/path/to/Cardano-mcp/dist/index.js"],
"env": {
"BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXX",
"CARDANO_NETWORK": "mainnet"
}
}
}
}
Claude Code
claude mcp add cardano -- node /absolute/path/to/Cardano-mcp/dist/index.js
Modules & tools
| Module | Phase | Tools | APIs |
|---|---|---|---|
query | 1 | 6 | Blockfrost, Koios, Maestro |
tokens | 1 | 4 | Blockfrost, Koios |
txbuilder | 1 | 5 | Blockfrost, Mesh SDK |
contracts | 2 | 7 | Blockfrost, Aiken CLI, CSL |
indexer | 2 | 4 | Kupo, Yaci Store |
governance | 3 | 12 | Koios |
Full tool reference: cardano-mcp.dev/tools
Development
pnpm dev # watch mode
pnpm test # vitest
pnpm typecheck # tsc --noEmit
pnpm lint # eslint src/
License
MIT © 2025 lidonation