Haiku-Trading/haiku-mcp-server

An MCP (Model Context Protocol) server that enables AI agents to execute blockchain transactions via the Haiku API.
Features
- **Token Discovery**: List supported tokens and DeFi assets across 21 blockchain networks
- **Balance Checking**: Get wallet balances across all supported chains
- **Trading Quotes**: Get quotes for swaps and portfolio rebalancing
- **Transaction Building**: Convert quotes to unsigned EVM transactions
- **Wallet Integration**: Extract EIP-712 payloads for external wallet signing (Coinbase, AgentKit, Safe, etc.)
- **Self-Contained Execution**: Optional end-to-end execution with WALLET_PRIVATE_KEY env var
- **Yield Discovery**: Find the highest-yielding DeFi opportunities across protocols and chains, filtered by APY, TVL, and category
- **Portfolio Analysis**: Analyze a wallet's holdings and surface context-specific yield opportunities based on what it actually holds
Installation
Or run directly with npx:
Configuration
Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| HAIKU_API_KEY | No | Your Haiku API key for higher rate limits. Contact contact@haiku.trade to request one. |
| HAIKU_BASE_URL | No | API base URL. Defaults to https://api.haiku.trade/v1 |
| WALLET_PRIVATE_KEY | No | Private key (0x hex) for self-contained execution via haiku_execute. |
| RPC_URL_{chainId} | No | Override RPC URL for a specific chain (e.g., RPC_URL_42161 for Arbitrum). |
> **Note:** The API works without a key, but providing one unlocks higher rate limits for production use.
Claude Desktop Configuration
Add to your claude_desktop_config.json:
With API key for higher rate limits:
Available Tools
haiku_get_tokens
Get supported tokens and DeFi assets for trading.
**Parameters:**
- network (optional): Filter by chain ID (e.g., 42161 for Arbitrum)
- category (optional): Filter by token category:
- token - Vanilla tokens (ETH, USDC, etc.)
- collateral - eg. Aave aTokens (deposited collateral)
- varDebt - eg. Aave variable debt tokens
- vault - eg. Yearn/Morpho yield vaults
- weightedLiquidity - eg. Balancer LP tokens
- concentratedLiquidity - eg. Uniswap V3 LP positions
**Example:**
haiku_get_balances
Get token balances for a wallet address across all chains.
**Parameters:**
- walletAddress (optional): Wallet address or ENS name. Required when WALLET_PRIVATE_KEY is not set; omit to auto-derive from WALLET_PRIVATE_KEY when it is set.
**Example:**
Omit walletAddress when WALLET_PRIVATE_KEY is set to use the derived address.
haiku_get_quote
Get a quote for a token swap or portfolio rebalance.
> **Note:** Quotes are valid for 5 minutes, but execute as quickly as possible after quoting — the longer you wait, the more likely prices have moved and the transaction will fail on-chain.
**Parameters:**
- inputPositions (required): Map of token IID to amount to spend
- targetWeights (required): Map of output token IID to weight (must sum to 1)
- slippage (optional): Max slippage as decimal (default: 0.003)
- receiver: Receiving wallet address. **Required when WALLET_PRIVATE_KEY is not set** — must be provided explicitly. When WALLET_PRIVATE_KEY is set, auto-derived if omitted. When WALLET_PRIVATE_KEY is not set (Path B), you must pass receiver explicitly.
**Example:**
Example above omits receiver (valid when WALLET_PRIVATE_KEY is set). For Path B, include "receiver": "0x...".
haiku_prepare_signatures
Extract and normalize EIP-712 signing payloads from a quote for external wallet signing (Path B only). When using quoteId, the quote must have been obtained in the same session.
Use this when a wallet MCP handles signing (Coinbase Payments MCP, wallet-agent, AgentKit, Safe, etc.). Returns standardized typed data that any wallet's signTypedData can consume, plus step-by-step instructions.
**Parameters:**
- quoteId (preferred): Quote ID from haiku_get_quote — server resolves the full quote from session cache. QuoteId only works when the quote was returned by haiku_get_quote in the same MCP session; otherwise use quoteResponse.