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 (63 tools)

# 1. Install & Setup Indigo MCP (57 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

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║   ██╗███╗   ██╗██████╗ ██╗ ██████╗  ██████╗                   ║
║   ██║████╗  ██║██╔══██╗██║██╔════╝ ██╔═══██╗                  ║
║   ██║██╔██╗ ██║██║  ██║██║██║  ███╗██║   ██║                  ║
║   ██║██║╚██╗██║██║  ██║██║██║   ██║██║   ██║                  ║
║   ██║██║ ╚████║██████╔╝██║╚██████╔╝╚██████╔╝                  ║
║   ╚═╝╚═╝  ╚═══╝╚═════╝ ╚═╝ ╚═════╝  ╚═════╝                   ║
║                                                               ║
║   ███╗   ███╗ ██████╗██████╗                                  ║
║   ████╗ ████║██╔════╝██╔══██╗                                 ║
║   ██╔████╔██║██║     ██████╔╝                                 ║
║   ██║╚██╔╝██║██║     ██╔═══╝                                  ║
║   ██║ ╚═╝ ██║╚██████╗██║                                      ║
║   ╚═╝     ╚═╝ ╚═════╝╚═╝                                      ║
║                                                               ║
║   63 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)
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

Quick Start

Automatic Setup (Recommended)

Run the interactive setup to automatically configure your MCP client:

npx @indigoprotocol/indigo-mcp setup

This will:

Ask which client you're using (Claude Desktop, Claude Code, Cursor, Windsurf)
Prompt for your Blockfrost API key
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

docker build -t indigo-mcp .
docker run -i indigo-mcp

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

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"

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

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/v1",
        "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/v1",
        "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/v1",
        "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/v1 \
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

Tool	Description	Parameters
`get_assets`	Get all Indigo iAssets with prices and interest data	None
`get_asset`	Get details for a specific iAsset	`asset`: iUSD, iBTC, iETH, or iSOL
`get_asset_price`	Get the current price for a specific iAsset	`asset`: iUSD, iBTC, iETH, or iSOL
`get_ada_price`	Get the current ADA price in USD	None
`get_indy_price`	Get the current INDY token price in ADA and USD	None

CDP / Loan Tools

Tool	Description	Parameters
`get_all_cdps`	Get all CDPs/loans, optionally filtered by iAsset	`asset?`: iAsset filter; `limit?`: 1-500 (default 50); `offset?`: pagination offset
`get_cdps_by_owner`	Get CDPs for a specific owner	`owner`: payment key hash (56-char hex) or bech32 address
`get_cdps_by_address`	Get CDPs for a specific Cardano address	`address`: bech32 address (addr1... or addr_test1...)
`analyze_cdp_health`	Analyze collateral ratios and liquidation risk	`owner`: payment key hash or bech32 address

CDP Write Tools

Tool	Description	Parameters
`open_cdp`	Open a new CDP position (returns unsigned CBOR tx)	`address`: bech32 address; `asset`: iUSD, iBTC, iETH, or iSOL; `collateralAmount`: lovelace; `mintAmount`: iAsset smallest unit
`deposit_cdp`	Deposit additional collateral into a CDP	`address`: bech32 address; `asset`: iAsset; `cdpTxHash`: CDP UTxO tx hash; `cdpOutputIndex`: output index; `amount`: lovelace
`withdraw_cdp`	Withdraw collateral from a CDP	`address`: bech32 address; `asset`: iAsset; `cdpTxHash`: CDP UTxO tx hash; `cdpOutputIndex`: output index; `amount`: lovelace
`close_cdp`	Close a CDP and reclaim collateral	`address`: bech32 address; `asset`: iAsset; `cdpTxHash`: CDP UTxO tx hash; `cdpOutputIndex`: output index

CDP Mint/Burn Tools

Tool	Description	Parameters
`mint_cdp`	Mint additional iAssets from an existing CDP (increases debt)	`address`: bech32 address; `asset`: iUSD, iBTC, iETH, or iSOL; `cdpTxHash`: CDP UTxO tx hash; `cdpOutputIndex`: CDP UTxO output index; `amount`: iAsset amount in smallest unit
`burn_cdp`	Burn iAssets to reduce CDP debt	`address`: bech32 address; `asset`: iUSD, iBTC, iETH, or iSOL; `cdpTxHash`: CDP UTxO tx hash; `cdpOutputIndex`: CDP UTxO output index; `amount`: iAsset amount in smallest unit

CDP Liquidation & Redemption Tools

Tool	Description	Parameters
`liquidate_cdp`	Liquidate an undercollateralized CDP through the stability pool	`address`: bech32 address; `asset`: iAsset; `cdpTxHash`: CDP UTxO tx hash; `cdpOutputIndex`: output index
`redeem_cdp`	Redeem iAssets from a CDP	`address`: bech32 address; `asset`: iAsset; `cdpTxHash`: CDP UTxO tx hash; `cdpOutputIndex`: output index; `amount`: iAsset amount in smallest unit
`freeze_cdp`	Freeze a CDP to prevent further operations	`address`: bech32 address; `asset`: iAsset; `cdpTxHash`: CDP UTxO tx hash; `cdpOutputIndex`: output index
`merge_cdps`	Merge multiple CDPs into one	`address`: bech32 address; `cdpOutRefs`: array of `{txHash, outputIndex}` (min 2)

Leverage CDP Tools

Tool	Description	Parameters
`leverage_cdp`	Open a leveraged CDP by redeeming against ROB positions	`address`: bech32 address; `asset`: iAsset; `leverage`: multiplier (e.g. 2.0); `baseCollateral`: lovelace amount

Stability Pool Tools

Tool	Description	Parameters
`get_stability_pools`	Get the latest stability pool state for each iAsset	None
`get_stability_pool_accounts`	Get all open stability pool accounts, optionally filtered by iAsset	`asset?`: iUSD, iBTC, iETH, or iSOL
`get_sp_account_by_owner`	Get stability pool accounts for specific owners	`owners`: array of payment key hashes or bech32 addresses

Staking Tools

Tool	Description	Parameters
`get_staking_info`	Get the current INDY staking manager state	None
`get_staking_positions`	Get all open INDY staking positions	None
`get_staking_positions_by_owner`	Get INDY staking positions for specific owners	`owners`: array of payment key hashes or bech32 addresses
`get_staking_position_by_address`	Get INDY staking positions for a single address	`address`: Cardano bech32 address

Stability Pool Request Tools

Tool	Description	Parameters
`process_sp_request`	Process a pending stability pool request (protocol maintenance)	`address`: bech32 address; `asset`: iAsset; `accountTxHash`: account UTxO tx hash; `accountOutputIndex`: output index
`annul_sp_request`	Cancel a pending stability pool request	`address`: bech32 address; `accountTxHash`: account UTxO tx hash; `accountOutputIndex`: output index

Staking Write Tools

Tool	Description	Parameters
`open_staking_position`	Stake INDY tokens by creating a new staking position	`address`: bech32 address; `amount`: INDY amount in smallest unit
`adjust_staking_position`	Adjust an existing staking position (add or remove INDY)	`address`: bech32 address; `amount`: positive=stake more, negative=unstake; `positionTxHash`: UTxO tx hash; `positionOutputIndex`: UTxO output index
`close_staking_position`	Close a staking position and unstake all INDY	`address`: bech32 address; `positionTxHash`: UTxO tx hash; `positionOutputIndex`: UTxO output index

Staking Reward Tools

Tool	Description	Parameters
`distribute_staking_rewards`	Distribute collected ADA rewards from collector UTxOs to stakers	`address`: bech32 address; `collectorTxHashes`: array of `{txHash, outputIndex}`

Analytics & APR Tools

Tool	Description	Parameters
`get_tvl`	Get historical TVL data from DefiLlama	None
`get_apr_rewards`	Get all APR reward records	None
`get_apr_by_key`	Get APR for a specific key	`key`: APR key (e.g. sp_iUSD_indy, stake_ada)
`get_dex_yields`	Get DEX farm yields for iAsset pairs	None
`get_protocol_stats`	Get aggregated protocol statistics	None

Governance Tools

Tool	Description	Parameters
`get_protocol_params`	Get latest governance protocol parameters	None
`get_temperature_checks`	Get temperature check polls	None
`get_polls`	Get all governance polls	None

Redemption & Order Book Tools

Tool	Description	Parameters
`get_order_book`	Get open limited redemption positions	`asset?`: iAsset filter; `owners?`: array of payment key hashes
`get_redemption_orders`	Get redemption orders with optional filters	`timestamp?`: Unix ms; `in_range?`: filter by price range
`get_redemption_queue`	Get aggregated redemption queue for an iAsset	`asset`: iUSD, iBTC, iETH, or iSOL

ROB Write Tools

Tool	Description	Parameters
`open_rob`	Open a new ROB position with ADA and a max price limit	`address`: bech32 address; `asset`: iAsset; `lovelacesAmount`: lovelace to deposit; `maxPrice`: on-chain integer string
`cancel_rob`	Cancel an existing ROB position	`address`: bech32 address; `robTxHash`: ROB UTxO tx hash; `robOutputIndex`: output index
`adjust_rob`	Adjust ADA in a ROB (positive to add, negative to remove)	`address`: bech32 address; `robTxHash`: ROB UTxO tx hash; `robOutputIndex`: output index; `lovelacesAdjustAmount`: adjustment; `newMaxPrice?`: optional new max price
`claim_rob`	Claim received iAssets from an ROB position	`address`: bech32 address; `robTxHash`: ROB UTxO tx hash; `robOutputIndex`: output index
`redeem_rob`	Redeem iAssets against one or more ROB positions	`address`: bech32 address; `redemptionRobs`: array of `{txHash, outputIndex, iAssetAmount}`; `priceOracleTxHash`; `priceOracleOutputIndex`; `iassetTxHash`; `iassetOutputIndex`

DEX Proxy Tools

Tool	Description	Parameters
`get_steelswap_tokens`	Get all tokens available on Steelswap DEX	None
`get_steelswap_estimate`	Get a swap estimate from Steelswap	`tokenIn`: input token; `tokenOut`: output token; `amountIn`: amount
`get_iris_liquidity_pools`	Get liquidity pools from Iris	`tokenA?`: first token; `tokenB?`: second token; `dex?`: DEX filter
`get_blockfrost_balances`	Get token balances for a Cardano address	`address`: Cardano bech32 address

Collector & IPFS Tools

Tool	Description	Parameters
`get_collector_utxos`	Get collector UTXOs for fee distribution	`length?`: max UTXOs to return
`store_on_ipfs`	Store text content on IPFS	`text`: content to store
`retrieve_from_ipfs`	Retrieve content from IPFS by CID	`cid`: IPFS content identifier

Environment Variables

Variable	Required	Default	Description
`INDEXER_URL`	No	`https://analytics.indigoprotocol.io/api/v1`	Indigo analytics API base URL
`BLOCKFROST_API_KEY`	For write ops	—	Blockfrost project ID for transaction building
`CARDANO_NETWORK`	No	`mainnet`	Cardano network: `mainnet`, `preprod`, or `preview`
`MCP_TRANSPORT`	No	`stdio`	Transport mode: `stdio` or `http`
`PORT`	No	`3000`	HTTP server port (only used when `MCP_TRANSPORT=http`)

Example Queries

When connected to an LLM agent, you can ask natural language questions like:

"What are the current prices of all Indigo iAssets?"
"What is the price of iUSD right now?"
"How much is ADA worth in USD?"
"Show me all iETH CDPs"
"What CDPs does this address own?" (paste a Cardano address)
"Analyze the health of my CDPs" (with your address or payment key hash)
"Are any of my positions at risk of liquidation?"
"Show me the current stability pool state"
"What are my stability pool deposits?" (with your address)
"How much INDY am I staking?" (with your address)
"What's the current TVL of Indigo?"
"What APR can I earn on iUSD stability pool?"
"What are the current governance protocol parameters?"
"Show me the iUSD redemption queue"
"Get a Steelswap estimate for swapping 100 ADA to iUSD"
"What are the current DEX yields for iAsset pairs?"

Development

Prerequisites

Node.js >= 18
npm

Setup

git clone https://github.com/IndigoProtocol/indigo-mcp.git
cd indigo-mcp
npm install
npm run dev      # run with tsx (hot reload)

Scripts

npm run build          # compile TypeScript
npm run start          # run compiled server
npm run dev            # run with tsx (hot reload)
npm run typecheck      # type-check without emitting
npm run lint           # eslint
npm run lint:fix       # eslint --fix
npm run format         # prettier
npm run format:check   # prettier --check
npm run test           # run tests
npm run test:watch     # run tests in watch mode

Project Structure

src/
├── index.ts                       # Server entry point (stdio transport)
├── types/
│   └── tx-types.ts                # UnsignedTxResult, TxSummary types
├── tools/
│   ├── index.ts                   # Tool registration hub
│   ├── asset-tools.ts             # 5 asset/price tools
│   ├── cdp-tools.ts               # 4 CDP/loan tools
│   ├── stability-pool-tools.ts    # 3 stability pool tools
│   ├── staking-tools.ts           # 4 INDY staking tools
│   ├── staking-write-tools.ts     # 3 INDY staking write tools
│   ├── staking-reward-tools.ts    # 1 staking reward distribution tool
│   ├── cdp-liquidation-tools.ts   # 4 CDP liquidation/redemption/freeze/merge tools
│   ├── leverage-cdp-tools.ts      # 1 leveraged CDP tool
│   ├── rob-write-tools.ts         # 5 ROB write tools

│   ├── sp-request-tools.ts        # 2 SP request processing tools
│   ├── analytics-tools.ts         # 5 analytics/APR tools
│   ├── governance-tools.ts        # 3 governance tools
│   ├── redemption-tools.ts        # 3 redemption/order book tools
│   ├── dex-tools.ts               # 4 DEX proxy tools
│   └── collector-tools.ts         # 3 collector/IPFS tools
├── resources/
│   └── index.ts                   # MCP resource definitions
├── tests/
│   ├── unit/
│   │   ├── tools/                 # Unit tests for each tool module
│   │   └── utils/                 # Unit tests for validators, address
│   └── integration/
│       └── indexer-client.test.ts # Integration test for HTTP client
└── utils/
    ├── index.ts                   # Re-exports
    ├── indexer-client.ts          # Axios client for Indigo analytics API
    ├── validators.ts              # Zod validators (AssetParam enum)
    ├── address.ts                 # Bech32 address → payment credential
    ├── lucid-provider.ts          # Lucid + Blockfrost singleton provider
    ├── sdk-config.ts              # SystemParams loader with cache
    └── tx-builder.ts              # Transaction builder → unsigned CBOR

Testing via stdin

The server communicates over stdio using JSON-RPC. You can test tools directly:

npm run build
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1.0"}}}' | node dist/index.js

License

ISC

Name		Name	Last commit message	Last commit date
Latest commit History 85 Commits
.github/workflows		.github/workflows
scripts		scripts
src		src
.env.example		.env.example
.gitignore		.gitignore
.nvmrc		.nvmrc
.prettierrc		.prettierrc
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
eslint.config.mjs		eslint.config.mjs
fly.toml		fly.toml
glama.json		glama.json
package-lock.json		package-lock.json
package.json		package.json
server.json		server.json
smithery.yaml		smithery.yaml
tsconfig.build.json		tsconfig.build.json
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

Folders and files

Latest commit

History

Repository files navigation

Indigo MCP

⚡ Quick Start — Full Cardano DeFi Stack

MCP Servers (63 tools)

AI Skills (13 skills) — Optional

Features

Quick Start

Automatic Setup (Recommended)

Manual Installation

Docker

HTTP Transport (Remote)

Configuration

Claude Desktop

Claude Code (CLI)

Cursor

Windsurf

OpenClaw

Combined with Cardano MCP

Any MCP-Compatible Client

Available Tools

Asset Tools

CDP / Loan Tools

CDP Write Tools

CDP Mint/Burn Tools

CDP Liquidation & Redemption Tools

Leverage CDP Tools

Stability Pool Tools

Staking Tools

Stability Pool Request Tools

Staking Write Tools

Staking Reward Tools

Analytics & APR Tools

Governance Tools

Redemption & Order Book Tools

ROB Write Tools

DEX Proxy Tools

Collector & IPFS Tools

Environment Variables

Example Queries

Development

Prerequisites

Setup

Scripts

Project Structure

Testing via stdin

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages