Haiku-Trading/haiku-mcp-server

Haiku-Trading/haiku-mcp-server

от haiku-trading
MCP-сервер для AI-агентов, выполняющий блокчейн-транзакции через Haiku API: токены, балансы, свопы, поиск доходности и анализ портфеля в 21 сети. Полезен разработчикам DeFi-ботов и автономных агентов.

Haiku MCP Server

An MCP (Model Context Protocol) server that enables AI agents to execute blockchain transactions via the Haiku API.

npm version GitHub

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

npm install haiku-mcp-server

Or run directly with npx:

npx haiku-mcp-server

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).
Инструменты были проиндексированы:
haiku_analyze_portfolio

Анализирует DeFi-портфель кошелька и выявляет релевантные доходные возможности. Возвращает текущие позиции, обогащённые доступными вариантами APY, показателями здоровья залога и контекстно-зависимыми возможностями на основе того, что реально хранится в кошельке. Используйте этот инструмент, когда пользователь спрашивает, что делать с портфелем, или хочет получить совет по оптимизации доходности. Объедините вывод с haiku_discover_yields для получения более широкого рыночного контекста, затем используйте haiku_get_quote для выполнения.

Параметры
  • walletAddressstringобязательный

    Адрес кошелька (0x...) для анализа

haiku_discover_yields

Находит доходные возможности в протоколах DeFi. Возвращает APY, TVL, параметры риска и идентификаторы токенов IID, готовые для haiku_get_quote. Используйте это для ответа на вопросы, например: «лучшие доходы по кредитованию на Arbitrum», «хранилища с самым высоким APY и TVL не менее 1M» или «что я могу сделать с USDC на BNB Chain». Поле iid в результатах можно использовать напрямую в качестве ключа targetWeight в haiku_get_quote.

Параметры
  • categoryenum

    lending: залоговые токены Aave, vault: хранилища Yearn/Morpho, lp: LP-токены Balancer/Uniswap, all: все категории, приносящие доход (по умолчанию: all)

  • limitnumber

    Максимальное количество результатов (по умолчанию: 50)

  • minApynumber

    Фильтр минимального APY в процентах, например, 5 означает ≥5% APY.

  • minTvlnumber

    Фильтр минимального TVL в USD, например, 1000000 означает ≥$1M TVL. Используйте его, чтобы отфильтровать проверенные основные хранилища и исключить пулы с низкой ликвидностью.

  • networknumber

    Фильтрует по сети. Распространённые сети: 42161 (Arbitrum), 8453 (Base), 1 (Ethereum), 137 (Polygon), 10 (Optimism), 56 (BNB Chain)

  • sortByenum

    Сортирует по APY (по умолчанию) или TVL, по убыванию.

haiku_execute

Выполните котировку. Сначала вызовите haiku_get_quote, затем выберите один из путей: • Путь A — Автономный (установлен WALLET_PRIVATE_KEY): передайте quoteId, sourceChainId, permit2SigningPayload + bridgeSigningPayload (если присутствует в котировке) и approvals. Haiku подписывает Permit2/bridge внутренне, отправляет любые approvals в сеть и транслирует транзакцию. Возвращает хеш транзакции. • Путь B — Внешний кошелёк (без WALLET_PRIVATE_KEY): требуется параметр broadcast: false. Сначала отправьте любые approvals из котировки через ваш MCP-кошелёк (каждый approval — это транзакция {to, data}). Затем, если нужны подписи, вызовите haiku_prepare_signatures → подпишите через MCP-кошелёк → вызовите haiku_execute с quoteId, sourceChainId, полученными подписями и broadcast: false. Возвращает { transaction: { to, data, value, chainId } } — отправьте эту транзакцию через ваш MCP-кошелёк. Всегда передавайте sourceChainId из ответа котировки.

Параметры
  • approvalsobject[]

    одобрения от haiku_get_quote. Только в автономном режиме: haiku транслирует их в блокчейн перед свопом. В режиме внешнего кошелька (broadcast: false) не передавайте их: транслируйте каждое одобрение {to, data} через ваш кошелёк MCP перед вызовом haiku_execute.

  • bridgeSigningPayloadobject

    bridgeSigningPayload из haiku_get_quote (только для кросс-чейн операций, для самостоятельной подписи)

  • broadcastboolean

    Если true (по умолчанию), транслирует транзакцию. Если false, возвращает неподписанную транзакцию.

  • permit2Signaturestring

    Предварительно подписанная подпись Permit2 (режим external wallet)

  • permit2SigningPayloadobject

    permit2SigningPayload из haiku_get_quote (для самодостаточного подписания)

  • quoteIdstringобязательный

    Quote ID из haiku_get_quote

  • sourceChainIdnumber

    Chain ID исходного токена (из haiku_get_quote). Рекомендуется: если не указан, сервер попытается восстановить его из подписанных данных или кэша сеанса, но передавать его явно безопаснее.

  • userSignaturestring

    Предварительно подписанная подпись интента моста (режим внешнего кошелька).

haiku_get_balances

Получает балансы токенов для адреса кошелька. По умолчанию запрашивает данные по всем поддерживаемым цепочкам. Передайте chainIds для частичного обновления — запрашиваются только указанные цепочки, это быстрее и полезно после свопа, когда нужны обновлённые балансы только для исходной и целевой цепочек. Возвращает балансы, цены в USD, общую стоимость портфеля и категоризированные позиции (токены, обеспечение, долг, хранилища). walletAddress необязателен, если в окружении задан WALLET_PRIVATE_KEY.

Параметры
  • chainIdsnumber[]

    Необязательный список chain ID, для которых нужно получить балансы. Если он указан, запрашиваются только эти цепочки (частичное обновление). Пример: [42161, 8453] для повторной загрузки только Arbitrum и Base после кросс-чейн свапа. Распространённые chain ID: 1 (Ethereum), 42161 (Arbitrum), 8453 (Base), 137 (Polygon), 10 (Optimism), 56 (BNB Chain), 80094 (Berachain). Если параметр опущен, загружаются все цепочки.

  • walletAddressstring

    Адрес кошелька (0x...) или ENS-имя. Опустите, чтобы автоматически определить из WALLET_PRIVATE_KEY.

haiku_get_quote

Получает котировку для свопа токенов или ребалансировки портфеля. Возвращает ожидаемые результаты, комиссии, оценки газа и все необходимые разрешения. Если требуются подписи (Permit2 или мост), в ответ включаются полезные нагрузки для подписи EIP-712. Два пути выполнения после получения котировки: • Путь A — автономный (установлен WALLET_PRIVATE_KEY): вызывает haiku_execute с quoteId, sourceChainId, permit2SigningPayload + bridgeSigningPayload (если присутствует в этом ответе) и approvals. Haiku подписывает и транслирует автоматически — возвращает хеш транзакции. • Путь B — внешний кошелек (wallet MCP, требуется broadcast: false): (1) сначала транслирует все разрешения {to, data} через wallet MCP; (2) вызывает haiku_prepare_signatures с quoteId, если нужны подписи — подписывает через wallet MCP; (3) вызывает haiku_execute с quoteId, sourceChainId, signatures и broadcast: false — возвращает { transaction: { to, data, value, chainId } } — транслирует транзакцию через wallet MCP.

Параметры
  • inputPositionsobjectобязательный

    Сопоставление IID токена и суммы. Формат IID: "<chain-slug>:<token-address>". Поддерживаемые chain-slug: arb=Arbitrum(42161), base=Base(8453), eth=Ethereum(1), poly=Polygon(137), opt=Optimism(10), bsc=BNB Chain(56), avax=Avalanche(43114), gnosis=Gnosis(100), sonic=Sonic(146), worldchain=World Chain(480), scroll=Scroll(534352), lisk=Lisk(1135), sei=Sei(1329), bera=Berachain(80094), bob=BOB(60808), hype=Hyperliquid(999), katana=Katana(747474), monad=Monad(143), plasma=Plasma(9745), uni=Unichain(130), ape=ApeCheain(33139), megaeth=MegaETH(4326). Пример: { "arb:0x82aF49447D8a07e3bd95BD0d56f35241523fBab1": "1.5" }

  • receiverstring

    Адрес кошелька для получения. Обязателен, когда WALLET_PRIVATE_KEY не задан: его нужно указать явно. Когда WALLET_PRIVATE_KEY задан, адрес автоматически выводится из него, если не указан.

  • slippagenumber

    Максимальное проскальзывание в виде десятичной дроби (например, 0.003 для 0,3%). По умолчанию: 0.003.

  • targetWeightsobjectобязательный

    Сопоставление IID выходного токена с весом (сумма весов равна 1). Пример: { "arb:0xaf88...": 0.5, "arb:0xFd08...": 0.5 }

haiku_get_tokens

Получает поддерживаемые токены и DeFi-позиции для торговли. Включает обычные токены, залог/долг Aave, доходные хранилища (yield vaults) и LP-токены. Используйте фильтр категорий, чтобы сузить результаты (например, 'collateral' для Aave aTokens). Возвращает IID токенов (уникальные идентификаторы), символы, названия, цены и информацию о сети. Используйте формат IID (chainSlug:tokenAddress) при указании токенов в других инструментах.

Параметры
  • categoryenum

    Фильтруйте по категории токенов: 'token' (обычные токены), 'collateral' (aTokens Aave), 'varDebt' (долговые токены Aave), 'vault' (вольты Yearn/Morpho), 'weightedLiquidity' (LP Balancer), 'concentratedLiquidity' (LP Uniswap V3). Опустите, чтобы вернуть все категории.

  • networknumber

    Фильтрует токены по сети. Популярные сети: 42161 (Arbitrum), 8453 (Base), 1 (Ethereum), 137 (Polygon), 10 (Optimism), 56 (BSC)

haiku_prepare_signatures

Внешний путь подписи кошелька — используйте его вместо передачи полезных нагрузок подписи напрямую в haiku_execute, когда WALLET_PRIVATE_KEY не установлен или когда подпись обрабатывает MCP кошелька (Coinbase Payments MCP, wallet-agent и т.д.). Извлекает и нормализует полезные нагрузки EIP-712 из котировки в стандартный формат, который может использовать signTypedData любого кошелька. Передавайте quoteId (предпочтительно) — сервер получает полную котировку из кэша сессии. В качестве альтернативы передайте полный объект quoteResponse, если quoteId недоступен. После внешней подписи передайте permit2Signature и/или userSignature в haiku_execute.

Параметры
  • quoteIdstring

    Идентификатор цитаты из haiku_get_quote (предпочтительно: сервер извлекает полную цитату из кэша сессии)

  • quoteResponseobject

    Полный ответ от haiku_get_quote (запасной вариант, когда quoteId недоступен).

0.0.9основная
0.0.8
0.0.7
0.0.6
0.0.5
0.0.4
0.0.3
0.0.2
0.0.1

Выберите клиент, чтобы установить Haiku-Trading/haiku-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "haiku-trading-haiku-mcp-server-t36xt0xzb1": {
      "command": "npx",
      "args": [
        "haiku-mcp-server"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "haiku-trading-haiku-mcp-server-t36xt0xzb1": {
      "command": "npx",
      "args": [
        "haiku-mcp-server"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "haiku-trading-haiku-mcp-server-t36xt0xzb1": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "haiku-mcp-server"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"haiku-trading-haiku-mcp-server-t36xt0xzb1\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"haiku-mcp-server\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "haiku-trading-haiku-mcp-server-t36xt0xzb1": {
      "command": "npx",
      "args": [
        "haiku-mcp-server"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add haiku-trading-haiku-mcp-server-t36xt0xzb1 -- npx haiku-mcp-server

Либо через JSON-конфиг:

claude mcp add-json haiku-trading-haiku-mcp-server-t36xt0xzb1 "{\"command\":\"npx\",\"args\":[\"haiku-mcp-server\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add haiku-trading-haiku-mcp-server-t36xt0xzb1 -- npx haiku-mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.haiku-trading-haiku-mcp-server-t36xt0xzb1]
command = "npx"
args = ["haiku-mcp-server"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите Haiku-Trading/haiku-mcp-server, а в поле команды запуска — строку ниже:
npx haiku-mcp-server

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "haiku-trading-haiku-mcp-server-t36xt0xzb1": {
      "command": "npx",
      "args": [
        "haiku-mcp-server"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "haiku-trading-haiku-mcp-server-t36xt0xzb1": {
      "command": "npx",
      "args": [
        "haiku-mcp-server"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например haiku-trading-haiku-mcp-server-t36xt0xzb1.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: haiku-trading-haiku-mcp-server-t36xt0xzb1
    command: npx
    args:
      - "haiku-mcp-server"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "haiku-trading-haiku-mcp-server-t36xt0xzb1": {
      "command": "npx",
      "args": [
        "haiku-mcp-server"
      ]
    }
  }
}

Похожие MCP-сервера

debridge-finance/debridge-mcp

debridge-finance/debridge-mcp

официальный

от debridge-finance

MCP сервер deBridge для ИИ-агентов: выполняет кросс-чейн и внутрисетевые свопы, оценивает комиссии и торгует на основных блокчейнах. Упрощает взаимодействие агентов с DeFi, ускоряя развертывание торговых сценариев.

TypeScript⭐ 31
kukapay/defi-yields-mcp

kukapay/defi-yields-mcp

от kukapay

MCP сервер для AI-агентов с фильтрацией и анализом DeFi-доходностей из DefiLlama. Анализирует APY, 30-дневное среднее и прогнозы. Включает готовый промпт. Помогает находить выгодные yield-возможности.

Python⭐ 16
kukapay/bridge-metrics-mcp

kukapay/bridge-metrics-mcp

от kukapay

MCP сервер для метрик кросс-чейн мостов. Предоставляет AI-агентам данные в реальном времени: списки цепей, мостов, исторические объемы, дневные токены и транзакции. Полезен разработчикам DeFi и ана...

Python⭐ 2
intentos-labs/beeper-mcp

intentos-labs/beeper-mcp

от intentos-labs

MCP-сервер для выполнения транзакций beeper в Binance Smart Chain. Проверяйте балансы, переводите BNB и токены, меняйте их через PancakeSwap, покупайте/продавайте токены и забирайте награды. Полезен для автоматизации DeFi-операций.

Python⭐ 3
KyuRish/trading212-mcp-server

KyuRish/trading212-mcp-server

от kyurish

Подключает AI-ассистента к Trading 212: спрашивай о портфеле, торгуй акциями, управляй пирогами и анализируй дивиденды на естественном языке. 32 инструмента — от маркет-ордеров до сводок по доходно...

Python⭐ 10
omniologynow-rgb/profitspot-mcp

omniologynow-rgb/profitspot-mcp

от omniologynow-rgb

ProfitSpot MCP - кросс-чейн DeFi-интеллект для AI-агентов с риск-скорингом, симуляциями Монте-Карло и трекингом китов по 86 сетям и 6500+ пулам. Даёт глубокую аналитику доходности и рисков.

Python⭐ 1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин