What are the requirements for Cardano MCP?

Cardano MCP requires the following environment variables: SEED_PHRASE (required), BLOCKFROST_PROJECT_ID (required), KUPO_URL (optional), OGMIOS_URL (optional), PORT (optional). You'll also need a compatible MCP client like Claude Desktop or Claude Code.

Is Cardano MCP free to use?

Yes, Cardano MCP is open source and free to use. You can find the source code on GitHub.

What MCP clients support Cardano MCP?

Cardano MCP works with any MCP-compatible client including Claude Desktop (Anthropic's official desktop app), Claude Code (CLI tool), Cursor, and other editors with MCP support.

How do I configure Cardano MCP?

Configure Cardano MCP by adding it to your MCP client's config file. The setup block at the top of this page generates a ready-to-paste config for Claude Code, Cursor, Codex, Windsurf, and Claude Desktop.

MCP server/other

Cardano MCP Server

Q: What tools does Cardano MCP provide?

wallet_tools: A suite of 6 tools for interacting with Cardano wallets, including address lookups, balance checks, and transaction submission..

Q: How do I install Cardano MCP?

Install Cardano MCP by running: npx @indigoprotocol/cardano-mcp setup

MCP server for interacting with the Cardano blockchain from AI agents

IndigoProtocol/cardano-mcp ↗by IndigoProtocolupdated Mar 22, 2026

Add it to Claude Code

claude mcp add -e "SEED_PHRASE=${SEED_PHRASE}" -e "BLOCKFROST_PROJECT_ID=${BLOCKFROST_PROJECT_ID}" cardano-mcp -- npx -y @indigoprotocol/cardano-mcp

Required:SEED_PHRASEBLOCKFROST_PROJECT_ID+ 3 optional

Make your agent remember this setup

cardano-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

Submit signed transactions to the Cardano network
Retrieve wallet addresses and UTxOs
Fetch token balances for ADA and native tokens
Resolve ADAHandles
Check stake delegation and claimable rewards

Tools 1

wallet_toolsA suite of 6 tools for interacting with Cardano wallets, including address lookups, balance checks, and transaction submission.

Environment Variables

SEED_PHRASErequiredYour wallet seed phrase (comma-separated)

BLOCKFROST_PROJECT_IDrequiredBlockfrost API key

KUPO_URLKupo endpoint URL (alternative to Blockfrost)

OGMIOS_URLOgmios endpoint URL (alternative to Blockfrost)

PORTHTTP server port

Try it

→Check the current ADA balance of my wallet.

→List the recent transaction history for my Cardano address.

→Resolve the ADAHandle for the user 'handle.me'.

→Check my current stake delegation and any claimable rewards.

→Submit a transaction to send 10 ADA to the specified address.

Original README from IndigoProtocol/cardano-mcp

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

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

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

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║    ██████╗ █████╗ ██████╗ ██████╗  █████╗ ███╗   ██╗ ██████╗  ║
║   ██╔════╝██╔══██╗██╔══██╗██╔══██╗██╔══██╗████╗  ██║██╔═══██╗ ║
║   ██║     ███████║██████╔╝██║  ██║███████║██╔██╗ ██║██║   ██║ ║
║   ██║     ██╔══██║██╔══██╗██║  ██║██╔══██║██║╚██╗██║██║   ██║ ║
║   ╚██████╗██║  ██║██║  ██║██████╔╝██║  ██║██║ ╚████║╚██████╔╝ ║
║    ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝  ║
║                                                               ║
║   ███╗   ███╗ ██████╗██████╗                                  ║
║   ████╗ ████║██╔════╝██╔══██╗                                 ║
║   ██╔████╔██║██║     ██████╔╝                                 ║
║   ██║╚██╔╝██║██║     ██╔═══╝                                  ║
║   ██║ ╚═╝ ██║╚██████╗██║                                      ║
║   ╚═╝     ╚═╝ ╚═════╝╚═╝                                      ║
║                                                               ║
║   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:

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:

npm install -g @indigoprotocol/cardano-mcp

Or run directly with npx:

npx @indigoprotocol/cardano-mcp

Docker

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):

{
  "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:

{
  "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):

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

Frequently Asked Questions

What are the key features of Cardano MCP?

Submit signed transactions to the Cardano network. Retrieve wallet addresses and UTxOs. Fetch token balances for ADA and native tokens. Resolve ADAHandles. Check stake delegation and claimable rewards.

What can I use Cardano MCP for?

Automating DeFi portfolio management and rebalancing. Building AI-powered blockchain explorers or wallet dashboards. Streamlining transaction signing workflows for developers. Integrating real-time on-chain data into AI research agents.

How do I install Cardano MCP?

Install Cardano MCP by running: npx @indigoprotocol/cardano-mcp setup

What MCP clients work with Cardano MCP?

Cardano MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep Cardano MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest

Add it to Claude Code

Make your agent remember this setup

What it does

Tools 1

Environment Variables

Try it

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

Frequently Asked Questions

Turn this server into reusable context

Related MCP Servers