io.github.IndigoProtocol/cardano-mcp

Official

by IndigoProtocol · TypeScript

Cardano MCP — transactions, addresses, UTxOs, balances, ADAHandles & stake delegation

Access Cardano blockchain data including transactions, addresses, UTxOs, and stake delegation.

Cardano MCP Server

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

Part of the Indigo AI Stack — use alongside Indigo MCP for full Cardano DeFi capabilities.

⚡ 2 Commands to Get Started

bash

# Install
npm install -g @indigoprotocol/cardano-mcp

# Setup (interactive)
npx @indigoprotocol/cardano-mcp setup

code

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║    ██████╗ █████╗ ██████╗ ██████╗  █████╗ ███╗   ██╗ ██████╗  ║
║   ██╔════╝██╔══██╗██╔══██╗██╔══██╗██╔══██╗████╗  ██║██╔═══██╗ ║
║   ██║     ███████║██████╔╝██║  ██║███████║██╔██╗ ██║██║   ██║ ║
║   ██║     ██╔══██║██╔══██╗██║  ██║██╔══██║██║╚██╗██║██║   ██║ ║
║   ╚██████╗██║  ██║██║  ██║██████╔╝██║  ██║██║ ╚████║╚██████╔╝ ║
║    ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝  ║
║                                                               ║
║   ███╗   ███╗ ██████╗██████╗                                  ║
║   ████╗ ████║██╔════╝██╔══██╗                                 ║
║   ██╔████╔██║██║     ██████╔╝                                 ║
║   ██║╚██╔╝██║██║     ██╔═══╝                                  ║
║   ██║ ╚═╝ ██║╚██████╗██║                                      ║
║   ╚═╝     ╚═╝ ╚═════╝╚═╝                                      ║
║                                                               ║
║   6 wallet tools for Cardano                                  ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

That's it — 6 wallet tools configured for Claude Desktop, Claude Code, Cursor, or Windsurf.

Features

Submit signed transactions to the Cardano network
Retrieve wallet addresses and UTxOs
Fetch token balances (ADA + native tokens)
Resolve ADAHandles (handle.me)
Check stake delegation and claimable rewards
Wallet-aware tools powered by Lucid Evolution

Quick Start

Automatic Setup (Recommended)

Run the interactive setup to automatically configure your MCP client:

bash

npx @indigoprotocol/cardano-mcp setup

This will:

Ask which client you're using (Claude Desktop, Claude Code, Cursor, Windsurf)
Prompt for your Blockfrost Project ID
Prompt for your wallet seed phrase (stored locally, never exposed to LLMs)
Automatically update your config file

Manual Installation

Install globally:

bash

npm install -g @indigoprotocol/cardano-mcp

Or run directly with npx:

bash

npx @indigoprotocol/cardano-mcp

Docker

bash

docker build -t cardano-mcp .
docker run -p 8000:8000 \
  -e PORT=8000 \
  -e SEED_PHRASE="your seed phrase here" \
  -e BLOCKFROST_PROJECT_ID="your_blockfrost_key" \
  cardano-mcp

Configuration

Environment Variables

Variable	Required	Description
`SEED_PHRASE`	Yes	Your wallet seed phrase (comma-separated). Never exposed to LLMs.
`BLOCKFROST_PROJECT_ID`	Yes*	Blockfrost API key from blockfrost.io
`KUPO_URL`	Alt	Kupo endpoint URL (alternative to Blockfrost)
`OGMIOS_URL`	Alt	Ogmios endpoint URL (alternative to Blockfrost)
`PORT`	No	HTTP server port (default: 8000)

*Either BLOCKFROST_PROJECT_ID or both KUPO_URL + OGMIOS_URL are required.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXXX"
      }
    }
  }
}

Claude Code (CLI)

Add to ~/.claude/settings.json or .claude/settings.json in your project:

json

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXXX"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-level):

json

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXXX"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json

{
  "mcpServers": {
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXXXXXXXXXXXXXX"
      }
    }
  }
}

OpenClaw

Install Cardano skills for OpenClaw:

bash

openclaw skills add IndigoProtocol/cardano-skills

Skills are automatically configured — start using Cardano wallet tools immediately.

Combined with Indigo MCP

For full Cardano DeFi capabilities, use both Cardano MCP and Indigo MCP together:

json

{
  "mcpServers": {
    "indigo": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/indigo-mcp"],
      "env": {
        "BLOCKFROST_API_KEY": "your-blockfrost-project-id"
      }
    },
    "cardano": {
      "command": "npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "SEED_PHRASE": "word1,word2,word3,...",
        "BLOCKFROST_PROJECT_ID": "your-blockfrost-project-id"
      }
    }
  }
}

Available Tools

Transaction Tools

Tool	Description	Parameters
`submit_transaction`	Sign and submit a Cardano transaction from the connected wallet	`cbor`: unsigned transaction CBOR hex string

Output: { transactionHash: string, timestamp: number }

Address Tools

Tool	Description	Parameters
`get_addresses`	Retrieve all Cardano addresses for the connected wallet	None

Output: { addresses: string[] }

UTxO Tools

Tool	Description	Parameters
`get_utxos`	Retrieve all UTxOs for the connected wallet in raw CBOR format	None

Output: { utxos: string[] } (CBOR hex encoded)

Balance Tools

Tool	Description	Parameters
`get_balances`	Retrieve all token balances for the connected wallet	None

Output:

json

{
  "balances": [
    {
      "name": "ADA",
      "policyId": "",
      "nameHex": "",
      "amount": 1500000000
    },
    {
      "name": "INDY",
      "policyId": "533bb94...",
      "nameHex": "494e4459",
      "amount": 100000000
    }
  ]
}

ADAHandle Tools

Tool	Description	Parameters
`get_adahandles`	Retrieve all ADAHandles (handle.me) owned by the connected wallet	None

Output: { adaHandles: string[] } (e.g., ["$myhandle", "$another"])

Staking Tools

Tool	Description	Parameters
`get_stake_delegation`	Retrieve stake pool delegation and available ADA rewards	None

Output:

json

{
  "poolId": "pool1...",
  "availableAdaRewards": 12.5
}

Example Usage

Check Wallet Balance

code

"What's my ADA balance?"

Claude will use get_balances and respond with your ADA and token holdings.

Submit a Transaction

code

"Submit this transaction: 84a400..."

Claude will use submit_transaction to sign and submit the CBOR transaction, returning the transaction hash.

Check Staking Rewards

code

"How much staking rewards do I have available?"

Claude will use get_stake_delegation to show your staked pool and claimable rewards.

Resolve ADAHandles

code

"What ADAHandles do I own?"

Claude will use get_adahandles to list all your handle.me handles.

Troubleshooting

nvm Users (macOS/Linux)

If you use nvm and Claude Desktop shows "server disconnected", you need to use full paths since Claude Desktop doesn't inherit your shell's nvm setup:

json

{
  "mcpServers": {
    "cardano": {
      "command": "/Users/YOU/.nvm/versions/node/v22.x.x/bin/npx",
      "args": ["-y", "@indigoprotocol/cardano-mcp"],
      "env": {
        "PATH": "/Users/YOU/.nvm/versions/node/v22.x.x/bin:/usr/local/bin:/usr/bin:/bin",
        "SEED_PHRASE": "word1,word2,...",
        "BLOCKFROST_PROJECT_ID": "mainnetXXX"
      }
    }
  }
}

Find your node path with: which npx

Cache Issues

If tools fail after an update, clear the npm cache:

bash

rm -rf ~/.npm/_npx

Then restart Claude Desktop.

Platform Support

Platform	Status	Notes
macOS	✅ Full support	Intel & Apple Silicon
Windows	✅ Full support	Windows 10/11
Linux	✅ Full support	x64 & ARM64

Security

⚠️ Important: Your seed phrase is stored locally and used only for wallet operations. It is never exposed to LLMs or external services.

The seed phrase is only used by the local Lucid Evolution wallet instance
All transaction signing happens locally before submission
No private keys are ever transmitted

Indigo MCP — 57 tools for Indigo Protocol (CDPs, staking, stability pools, DEX)
Indigo AI Skills — AI agent skills for Indigo workflows
Cardano AI Skills — AI agent skills for Cardano operations

Disclaimer

By using this Cardano MCP Server and all related tools and technology ("MCP"), you acknowledge and agree that:

Your use of decentralized finance, including MCP and/or AI agents that you empower to manage your digital assets, involves various significant financial risks
These risks include but are not limited to: risk of financial loss caused by MCP design or instructions, impermanent loss, and changes in digital asset prices
You are solely responsible for all MCP actions and transactions
You are solely responsible for securing your seed phrase, private keys, and environment configuration

License

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "cardano-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@indigoprotocol/cardano-mcp@1.0.2"
      ]
    }
  }
}

Cardano MCP Server

⚡ 2 Commands to Get Started

Features

Quick Start

Automatic Setup (Recommended)

Manual Installation

Docker

Configuration

Environment Variables

Claude Desktop

Claude Code (CLI)

Cursor

Windsurf

OpenClaw

Combined with Indigo MCP

Available Tools

Transaction Tools

Address Tools

UTxO Tools

Balance Tools

ADAHandle Tools

Staking Tools

Example Usage

Check Wallet Balance

Submit a Transaction

Check Staking Rewards

Resolve ADAHandles

Troubleshooting

nvm Users (macOS/Linux)

Cache Issues

Platform Support

Security

Related Projects

Disclaimer

License

Install