← Research

Справочник MCP-инструментов

Всё, что Claude может сделать через MCP, сгруппировано по требуемой роли. Чтение сверху, запись посередине, админ внизу — viewer-токен никогда не дотягивается до инструмента ниже своей линии.

Viewer

  • get_my_balance() — всё дерево капитала (кэш, длинные аллокации, торговые аккаунты, итого). Нелинейное: торговый NAV отражает PnL и маржу, а не аллокацию.
  • list_strategies() — стратегии, доступные вызывающему на чтение (свои + публичные + все, если operator/admin).
  • get_state(strategy) — полное состояние одной стратегии: equity, просадка, активы, сигналы, режим, веса.
  • list_trades(strategy, limit?) — недавние сделки.
  • get_equity_curve(strategy, days?) — история equity.
  • list_pending_approvals(strategy) — очередь согласований HIL.
  • get_trading_account(strategy_id) — живой торговый NAV, кэш, использованная маржа, PnL. Только владельцу.

Operator

  • set_mode(strategy, mode) — NORMAL / CAUTIOUS / MANUAL / PAUSED / EMERGENCY.
  • approve_trade(approval_id, decision, comment?) — закрыть согласование HIL из очереди.
  • allocate_to_long(strategy, amount) — перевести USD из вашего кэша в длинную аллокацию вашей стратегии.
  • allocate_to_trading(strategy_id, amount) — перевести USD из вашего кэша в торговый аккаунт вашей стратегии.

Admin

  • create_invite(role, email_hint?, ttl_hours?) — сгенерировать одноразовую ссылку для регистрации.
  • credit_cash(user_id, amount, note?) — пополнить ledger пользователя (для начального заведения балансов).
  • list_users() — список пользователей для админа.

Ошибки прав

Если вы зовёте инструмент выше своей роли, в ответе придёт `isError: true` и текст `Requires <role> role`. Скилл обрабатывает это спокойно — показывает ошибку и останавливается, без повторов.

Владение данными

  • Портфельные стратегии принадлежат одному пользователю. Чтение — по владельцу и флагу `is_public`. Запись — по владельцу и роли.
  • Торговые аккаунты строго привязаны к владельцу. Публичного чтения нет. Записи между пользователями нет.
  • Движения капитала (`allocate_to_*`) атомарны и пишутся в аудит.