Cardano Mcp

io.github.IndigoProtocol由 GitHub 帳號 IndigoProtocol 發布v1.0.2更新於 Oct 24, 2026

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

已驗證STDIO僅桌面金融開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，讓 AI 助理讀取 Cardano 錢包的位址、UTxO、餘額、ADAHandle 與質押資訊，並簽署及送出交易。

可以做什麼
讀取所連接錢包的位址與原始 UTxO，以及 ADA 和原生代幣餘額與持有的 ADAHandle。查詢質押池委託與可領取的 ADA 獎勵。對以 CBOR 十六進位提供的未簽署 Cardano 交易進行簽署並送出，回傳交易雜湊與時間戳。錢包相關工具執行於本機 Lucid Evolution 錢包實例。
適用情境
當你希望助理檢視 Cardano 錢包或把準備好的交易送到網路時使用，例如查詢餘額、ADAHandle 或質押獎勵，或送出在別處建立的 CBOR。適合願意在本機設定中保存助記詞的使用者。
執行需求
以 npm 套件透過 stdio 在本機執行，需要 Node.js 與 npx。需要錢包助記詞（SEED_PHRASE），以及 BLOCKFROST_PROJECT_ID 中的 Blockfrost 專案 ID，或同時提供 KUPO_URL 與 OGMIOS_URL。需要連線至 Cardano 資料提供者的網路；安裝程式會寫入用戶端設定檔。
安裝前請注意
伺服器需要 SEED_PHRASE 中的錢包助記詞，它掌控錢包資金，任何能讀取該設定的人都能動用資金。submit_transaction 會在 Cardano 網路上簽署並廣播真實交易，出錯可能造成資金損失。README 稱助記詞不會暴露給大型語言模型且簽署在本機完成，但設定與環境仍須自行妥善保管。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Cardano Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 c9ff7b6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分