S
SkillNav

io.github.IndigoProtocol/cardano-mcp

编码与调试

by indigoprotocol

Cardano MCP 工具集，支持交易、地址、UTxOs、余额、ADAHandles 与质押委托查询。

2GitHub

什么是 io.github.IndigoProtocol/cardano-mcp？

Cardano MCP 工具集，支持交易、地址、UTxOs、余额、ADAHandles 与质押委托查询。

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

  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

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

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

常见问题

io.github.IndigoProtocol/cardano-mcp 是什么？

Cardano MCP 工具集，支持交易、地址、UTxOs、余额、ADAHandles 与质押委托查询。

相关 Skills

前端设计

by anthropics

Universal
热门

面向组件、页面、海报和 Web 应用开发，按鲜明视觉方向生成可直接落地的前端代码与高质感 UI，适合做 landing page、Dashboard 或美化现有界面，避开千篇一律的 AI 审美。

✎ 想把页面做得既能上线又有设计感，就用前端设计：组件到整站都能产出，难得的是能避开千篇一律的 AI 味。

编码与调试
未扫描165.3k

网页应用测试

by anthropics

Universal
热门

用 Playwright 为本地 Web 应用编写自动化测试，支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志，适合调试动态页面和回归验证。

✎ 借助 Playwright 一站式验证本地 Web 应用前端功能，调 UI 时还能同步查看日志和截图，定位问题更快。

编码与调试
未扫描165.3k

网页构建器

by anthropics

Universal
热门

面向复杂 claude.ai HTML artifact 开发，快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML，适合需要状态管理、路由或多组件交互的页面。

✎ 在 claude.ai 里做复杂网页 Artifact 很省心，多组件、状态和路由都能顺手搭起来，React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。

编码与调试
未扫描165.3k

相关 MCP Server

GitHub

编辑精选

by GitHub

热门

GitHub 是 MCP 官方参考服务器，让 Claude 直接读写你的代码仓库和 Issues。

✎ 这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题，适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现，生产环境得自己加固安全。

编码与调试
89.1k

Context7 文档查询

编辑精选

by Context7

热门

Context7 是实时拉取最新文档和代码示例的智能助手，让你告别过时资料。

✎ 它能解决开发者查找文档时信息滞后的问题，特别适合快速上手新库或跟进更新。不过，依赖外部源可能导致偶尔的数据延迟，建议结合官方文档使用。

编码与调试
60.0k

io.github.tldraw/tldraw

编辑精选

by tldraw

热门

tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。

✎ 这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过，目前它只是个基础连接器，你得自己搭建画布应用才能发挥全部潜力。

编码与调试
49.5k

评论