← Research

Referência de ferramentas MCP

Tudo que o Claude pode fazer via MCP, agrupado pelo papel necessário. Leitura no topo, escrita no meio, admin no fim — um token viewer nunca alcança uma ferramenta abaixo da sua linha.

Viewer

  • get_my_balance() — árvore completa de capital (cash, alocações long, contas de trading, total). Não-linear - o nav de trading reflete PnL/margem, não a alocação.
  • list_strategies() — estratégias que o chamador consegue ler (próprias + públicas + todas se operator/admin).
  • get_state(strategy) — estado completo de uma estratégia: patrimônio, drawdown, sleeves, sinais, regime, pesos.
  • list_trades(strategy, limit?) — operações recentes.
  • get_equity_curve(strategy, days?) — histórico de patrimônio.
  • list_pending_approvals(strategy) — aprovações HIL pendentes.
  • get_trading_account(strategy_id) — nav de trading ao vivo, cash, margin_used, PnL. Apenas o dono.

Operator

  • set_mode(strategy, mode) — NORMAL / CAUTIOUS / MANUAL / PAUSED / EMERGENCY.
  • approve_trade(approval_id, decision, comment?) — resolver uma aprovação HIL pendente.
  • allocate_to_long(strategy, amount) — mover USD do seu cash para uma alocação long que você possui.
  • allocate_to_trading(strategy_id, amount) — mover USD do seu cash para uma conta de trading que você possui.

Admin

  • create_invite(role, email_hint?, ttl_hours?) — gerar um link de cadastro de uso único.
  • credit_cash(user_id, amount, note?) — creditar o ledger de um usuário (bootstrap de saldos).
  • list_users() — listagem de usuários para admin.

Erros de permissão

Se você chamar uma ferramenta acima do seu papel, a resposta carrega `isError: true` e o texto `Requires <role> role`. A skill trata isso elegantemente - mostra o erro e para, não tenta de novo.

Propriedade dos dados

  • Estratégias de portfolio (long sleeves) pertencem a um único usuário. Leituras obedecem propriedade + flag `is_public`. Escritas obedecem propriedade + papel.
  • Contas de trading são strict-owner. Sem leitura pública. Sem escrita cross-user.
  • Fluxos de capital (`allocate_to_*`) são atômicos e auditados.