A Model Context Protocol server for the Cardano ledger.

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
yarn install && yarn 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	13	Koios

Full tool reference: cardano-mcp.dev/tools

Development

yarn dev        # watch mode
yarn test       # vitest
yarn typecheck  # tsc --noEmit
yarn lint       # eslint src/

Claude Code plugins

plugins/ is a small marketplace of Claude Code plugins built on this server — install the whole repo as a marketplace:

claude plugin marketplace add /path/to/Cardano-mcp
claude plugin install cardano-verify@cardano-mcp-plugins

Plugin	What it does
cardano-verify	Compile-checks Aiken code against the real compiler; confirms network + amount before submit_transaction
cardano-concepts	Grounds eUTxO/governance answers in this repo's own reference docs
cardano-status-codes	Diagnoses tool errors against a catalog of what Blockfrost/Koios/Maestro/Kupo/ledger failures actually mean
cardano-tooling	Checks local Kupo/Yaci Store sidecars are reachable before calling the indexer module

Demo app

demo-app/ is a Vite + React browser client with its own Express bridge server (demo-app/server.ts) that wraps the same Blockfrost/Koios calls the MCP server makes and exposes them as plain HTTP endpoints — useful for exercising Cardano queries from a browser UI outside a chat client, without going through MCP itself.

License

MIT © 2025 lidonation