IndigoProtocol/cardano-mcp

A Model Context Protocol (MCP) server for interacting with the Cardano blockchain from AI agents and automation systems.

This server exposes wallet-aware tools for:

• Submitting transactions

• Fetching addresses

• Reading UTxOs

• Fetching balances

• Resolving ADAHandles

• Checking stake delegation

Secrets

1. Copy the .env.example file to a new file .env

2. Specify your seed-phrase (SEED_PHRASE). Your seed-phrase is NEVER exposed to LLMs, and is only used for local wallet connection.

3. Configure the wallet connection details. Specify a Blockfrost Project ID (https://blockfrost.io/), or a Kupo & Ogmios URL.

Docker Installation

Build the container

docker build -t cardano-mcp .

Run with your secrets

docker run -p 8000:8000 \
  -e PORT=8000 \
  -e SEED_PHRASE="lizard,llama,frog..." \
  -e BLOCKFROST_PROJECT_ID="your_blockfrost_key" \
  cardano-mcp

Manual Installation

Clone this repository

git clone https://github.com/IndigoProtocol/cardano-mcp.git

Install dependencies

cd cardano-mcp
npm install

Build & Run

npm run dev
- or -
npm run build
npm run start

Connecting

The URL for the Cardano MCP server will be hosted at http://localhost:8000/mcp

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cardano": {
      "command": "node",
      "args": ["/path/to/cardano-mcp/dist/index.js"],
      "env": {
        "SEED_PHRASE": "lizard,llama,frog..."
        "BLOCKFROST_PROJECT_ID": "mainnet123..."
      }
    }
  }
}

Disclaimer

By using this Cardano MCP Server and all related tools and technology (“MPC”), you acknowledge and agree that (i) your use of decentralized finance, including MPC and/or AI agents that you empower to manage your digital assets, involves various significant financial risks, including but not limited to, the risk of financial loss caused by MPC design or instructions, impermanent loss, and changes in digital asset prices; and (ii) that you are solely responsible for all MPC actions and transactions, and for securing your seed phrase, private keys, and environment configuration.