IndigoProtocol/cardano-mcp

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
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:
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:
Or run directly with npx:
Docker
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):
Claude Code (CLI)
Add to ~/.claude/settings.json or .claude/settings.json in your project:
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-level):
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
OpenClaw
Install Cardano skills for OpenClaw:
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:
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:**
ADAHandle Tools
| Tool | Description | Parameters |
|------|-------------|------------|