Indigo MCP

Indigo MCP

MCP server for Indigo Protocol — exposes Indigo iAsset data, prices, and CDP/loan analytics to LLM agents via the Model Context Protocol.

⚡ Quick Start — Full Cardano DeFi Stack

MCP Servers (75 tools)

# 1. Install & Setup Indigo MCP (69 tools)

npm install -g @indigoprotocol/indigo-mcp npx @indigoprotocol/indigo-mcp setup

2. Install & Setup Cardano MCP (6 wallet tools)

npm install -g @indigoprotocol/cardano-mcp npx @indigoprotocol/cardano-mcp setup

AI Skills (13 skills) — Optional

# 3. Install Indigo Skills

npx @indigoprotocol/indigo-skills

4. Install Cardano Skills

npx @indigoprotocol/cardano-skills

╔═══════════════════════════════════════════════════════════════╗ ║ ║ ║ ██╗███╗ ██╗██████╗ ██╗ ██████╗ ██████╗ ║ ║ ██║████╗ ██║██╔══██╗██║██╔════╝ ██╔═══██╗ ║ ║ ██║██╔██╗ ██║██║ ██║██║██║ ███╗██║ ██║ ║ ║ ██║██║╚██╗██║██║ ██║██║██║ ██║██║ ██║ ║ ║ ██║██║ ╚████║██████╔╝██║╚██████╔╝╚██████╔╝ ║ ║ ╚═╝╚═╝ ╚═══╝╚═════╝ ╚═╝ ╚═════╝ ╚═════╝ ║ ║ ║ ║ ███╗ ███╗ ██████╗██████╗ ║ ║ ████╗ ████║██╔════╝██╔══██╗ ║ ║ ██╔████╔██║██║ ██████╔╝ ║ ║ ██║╚██╔╝██║██║ ██╔═══╝ ║ ║ ██║ ╚═╝ ██║╚██████╗██║ ║ ║ ╚═╝ ╚═╝ ╚═════╝╚═╝ ║ ║ ║ ║ 75 tools • 13 skills for Cardano DeFi ║ ║ ║ ╚═══════════════════════════════════════════════════════════════╝

The setup commands auto-configure Claude Desktop, Claude Code, Cursor, or Windsurf. No manual config editing needed.

Features

• Real-time iAsset prices (iUSD, iBTC, iETH, iSOL, iEUR, iJPY)
• ADA and INDY token price feeds
• CDP/loan browsing with pagination and filtering
• Owner lookup by payment key hash or bech32 address
• CDP health analysis with collateral ratio and liquidation risk status
• Stability pool state and account queries
• INDY staking positions and manager state
• Protocol analytics: TVL, APR rewards, DEX yields, aggregated stats
• Governance: protocol parameters, polls, temperature checks
• Redemption order book and queue aggregation
• DEX proxy: Steelswap swaps, Iris liquidity pools, Blockfrost balances
• CDP liquidation, redemption, freeze, and merge operations
• Leveraged CDP opening via ROB positions
• ROB (Redemption Order Book) position management
• Oracle interest rate feeding and initialization
• Stability pool request processing and cancellation
• Staking reward distribution
• Collector UTXOs, IPFS storage and retrieval

Hosted deployment

A hosted deployment is available on Fronteir AI.

Quick Start

Automatic Setup (Recommended)

Run the interactive setup to automatically configure your MCP client:

npx @indigoprotocol/indigo-mcp setup

This will:

1. Ask which client you're using (Claude Desktop, Claude Code, Cursor, Windsurf)
2. Prompt for your Blockfrost API key
3. Automatically update your config file

Manual Installation

Install globally:

npm install -g @indigoprotocol/indigo-mcp

Or run directly with npx (no install needed):

npx @indigoprotocol/indigo-mcp

Docker

The image builds the server from source — no prior pnpm build needed, and no dependency on any external build step:

docker build -t indigo-mcp .

docker run -p 3000:3000 -e BLOCKFROST_API_KEY=your-key indigo-mcp

It runs the HTTP transport on port 3000 (MCP_TRANSPORT=http is baked in), which is what the Fly deployment uses.

HTTP Transport (Remote)

The server supports HTTP transport for remote/hosted deployments:

MCP_TRANSPORT=http PORT=3000 npx @indigoprotocol/indigo-mcp

This starts an HTTP server with:

• POST /mcp — MCP endpoint (Streamable HTTP with SSE)
• GET /health — Health check

Each client gets its own session: initialize returns an Mcp-Session-Id that subsequent requests must send back. A client that restarts can simply initialize again — existing sessions are unaffected and the server does not need restarting. Bind address and port come from HOST and PORT (MCP_PORT is accepted as an alias for PORT).

Configuration

Note: BLOCKFROST_API_KEY is required for write operations (transaction building). Read-only tools work without it. Get a free key at blockfrost.io.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

# macOS

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows (PowerShell)

notepad "$env:APPDATA\Claude\claude_desktop_config.json"

Standard config:

{

"mcpServers": { "indigo": { "command": "npx", "args": ["-y", "@indigoprotocol/indigo-mcp"], "env": { "INDEXER_URL": "https://analytics.indigoprotocol.io/api", "BLOCKFROST_API_KEY": "your-blockfrost-project-id" } } } }

For nvm users (multiple Node versions):

If you use nvm and have multiple Node versions, you may need to specify the full path and set PATH explicitly:

{

"mcpServers": { "indigo": { "command": "/Users/YOUR_USERNAME/.nvm/versions/node/v22.22.0/bin/npx", "args": ["-y", "@indigoprotocol/indigo-mcp"], "env": { "PATH": "/Users/YOUR_USERNAME/.nvm/versions/node/v22.22.0/bin:/usr/local/bin:/usr/bin:/bin", "INDEXER_URL": "https://analytics.indigoprotocol.io/api", "BLOCKFROST_API_KEY": "your-blockfrost-project-id" } } } }

Note: Replace YOUR_USERNAME and Node version with your actual values. Find your Node path with which npx.

Claude Code (CLI)

Add to ~/.claude/settings.json or .claude/settings.json in your project:

nano ~/.claude/settings.json

{

"mcpServers": { "indigo": { "command": "npx", "args": ["-y", "@indigoprotocol/indigo-mcp"], "env": { "INDEXER_URL": "https://analytics.indigoprotocol.io/api", "BLOCKFROST_API_KEY": "your-blockfrost-project-id" } } } }

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-level):

{

"mcpServers": { "indigo": { "command": "npx", "args": ["-y", "@indigoprotocol/indigo-mcp"], "env": { "INDEXER_URL": "https://analytics.indigoprotocol.io/api", "BLOCKFROST_API_KEY": "your-blockfrost-project-id" } } } }

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "indigo": { "command": "npx", "args": ["-y", "@indigoprotocol/indigo-mcp"], "env": { "INDEXER_URL": "https://analytics.indigoprotocol.io/api", "BLOCKFROST_API_KEY": "your-blockfrost-project-id" } } } }

OpenClaw

Install Indigo skills for OpenClaw:

openclaw skills add IndigoProtocol/indigo-skills

Skills are automatically configured — start using Indigo tools immediately.

Combined with Cardano MCP

For full Cardano DeFi capabilities, use both Indigo MCP and Cardano MCP together:

{

"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" } } } }

Any MCP-Compatible Client

Run the server directly via stdio:

INDEXER_URL=https://analytics.indigoprotocol.io/api \

BLOCKFROST_API_KEY=your-blockfrost-project-id \ npx @indigoprotocol/indigo-mcp

Or install globally and reference the binary:

npm install -g @indigoprotocol/indigo-mcp

indigo-mcp

For any client that supports MCP over stdio, point it to the npx @indigoprotocol/indigo-mcp command with the environment variables above.

Available Tools

Asset Tools

CDP / Loan Tools

CDP Write Tools

Pyth-priced iAssets have a submission deadline. Every iAsset is currently

priced through Pyth, and the on-chain feed validator only accepts a transaction

for 280 seconds after the price update it embeds. Price-dependent write

tools (open_cdp, withdraw_cdp, mint_cdp, redeem_cdp, freeze_cdp,

leverage_cdp, redeem_rob) therefore return a summary.pyth block with the

price, its timestamp and a submitBefore deadline. If signing takes longer

than that — a hardware wallet, or a human approving in a browser — rebuild the

transaction rather than submitting a stale one. A price update that has already

expired is rejected at build time with a retry hint.