Cardano Mcp

io.github.IndigoProtocolPublished by GitHub account IndigoProtocolv1.0.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceDeveloper Tools

Overview

AI-generated overview

Local MCP server that lets an AI assistant read a Cardano wallet's addresses, UTxOs, balances, ADAHandles and staking, and sign and submit transactions.

What you can do
Read wallet addresses and raw UTxOs for the connected wallet, plus token balances for ADA and native tokens and owned ADAHandles. Check stake pool delegation and claimable ADA rewards. Sign and submit an unsigned Cardano transaction supplied as CBOR hex, returning the transaction hash and timestamp. Wallet-aware tools run on a local Lucid Evolution wallet instance.
When to use it
Use it when you want an assistant to inspect a Cardano wallet or push a prepared transaction to the network, for example checking balances, handles or staking rewards, or submitting CBOR built elsewhere. It is aimed at Cardano users who are comfortable holding a seed phrase in a local config.
Requirements
Runs locally over stdio as an npm package, so Node.js and npx are needed. Requires a wallet seed phrase in SEED_PHRASE and either a Blockfrost project ID in BLOCKFROST_PROJECT_ID or both KUPO_URL and OGMIOS_URL. Network access to Cardano data providers is required; setup can write client config files.
Before you install
The server needs your wallet seed phrase in SEED_PHRASE, which controls the wallet's funds; anyone who reads the config can spend them. submit_transaction signs and broadcasts real transactions on the Cardano network, so mistakes can cost funds. The README states the seed phrase is never exposed to LLMs and signing is local, but you must secure the config and environment yourself.

Installation

In SourceWeft

  1. Open Cardano Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Cardano MCP Server

[Smithery] [npm downloads] [Ask DeepWiki]

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
# Installnpm 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:

bash
npx @indigoprotocol/cardano-mcp setup

This will:

  1. Ask which client you're using (Claude Desktop, Claude Code, Cursor, Windsurf)
  2. Prompt for your Blockfrost Project ID
  3. Prompt for your wallet seed phrase (stored locally, never exposed to LLMs)
  4. 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

VariableRequiredDescription
SEED_PHRASEYesYour wallet seed phrase (comma-separated). Never exposed to LLMs.
BLOCKFROST_PROJECT_IDYes*Blockfrost API key from blockfrost.io
KUPO_URLAltKupo endpoint URL (alternative to Blockfrost)
OGMIOS_URLAltOgmios endpoint URL (alternative to Blockfrost)
PORTNoHTTP 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

ToolDescriptionParameters
submit_transactionSign and submit a Cardano transaction from the connected walletcbor: unsigned transaction CBOR hex string

Output: { transactionHash: string, timestamp: number }

Address Tools

ToolDescriptionParameters
get_addressesRetrieve all Cardano addresses for the connected walletNone

Output: { addresses: string[] }

UTxO Tools

ToolDescriptionParameters
get_utxosRetrieve all UTxOs for the connected wallet in raw CBOR formatNone

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

Balance Tools

ToolDescriptionParameters
get_balancesRetrieve all token balances for the connected walletNone

Output:

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

ADAHandle Tools

ToolDescriptionParameters
get_adahandlesRetrieve all ADAHandles (handle.me) owned by the connected walletNone

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

Staking Tools

ToolDescriptionParameters
get_stake_delegationRetrieve stake pool delegation and available ADA rewardsNone

Output:

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

Example Usage

Check Wallet Balance

"What's my ADA balance?"

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

Submit a Transaction

"Submit this transaction: 84a400..."

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

Check Staking Rewards

"How much staking rewards do I have available?"

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

Resolve ADAHandles

"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

PlatformStatusNotes
macOS✅ Full supportIntel & Apple Silicon
Windows✅ Full supportWindows 10/11
Linux✅ Full supportx64 & 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

Related Projects

Disclaimer

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

  1. Your use of decentralized finance, including MCP and/or AI agents that you empower to manage your digital assets, involves various significant financial risks
  2. 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
  3. You are solely responsible for all MCP actions and transactions
  4. You are solely responsible for securing your seed phrase, private keys, and environment configuration

License

MIT

Source: README.md at commit c9ff7b6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts