# Ferramentas disponíveis

> As 31 ferramentas que o seu assistente recebe, e o que cada grupo faz.

Um token somente leitura recebe 24 ferramentas. Com edição, 31. Você não precisa decorar nada disto — o assistente escolhe a ferramenta certa a partir do que você pede. A lista existe para você saber o que é possível.

## Consulta de operações

| Ferramenta | O que faz |
| :-- | :-- |
| `list_trades` | Lista operações com filtros de período, conta, ativo, tag e estratégia. |
| `get_trade` | Detalha uma operação específica, incluindo a anotação e as imagens anexadas. |
| `get_trading_snapshot` | Retrato rápido do momento atual da conta. |
| `get_trading_overview` | Visão geral consolidada do período. |
| `get_pre_market_brief` | Resumo de preparação para o pregão. |

## Análises

| Ferramenta | O que faz |
| :-- | :-- |
| `get_analytics_summary` | Resultado, taxa de acerto, fator de lucro e expectativa. |
| `get_equity_curve` | Série da curva de capital. |
| `get_drawdown` | Série de drawdown ao longo do período. |
| `get_calendar` | Resultado dia a dia no formato de calendário. |
| `get_day_stats` | Estatísticas de dias positivos, negativos e neutros. |
| `get_streaks` | Sequências de ganhos e perdas consecutivas. |
| `get_performance_by_strategy` | Desempenho isolado de cada estratégia. |
| `get_asset_distribution` | Resultado por ativo. |
| `get_weekday_distribution` | Resultado por dia da semana. |
| `get_hourly_performance` | Resultado por faixa de horário. |
| `get_rating_distribution` | Relação entre nota de execução e resultado. |
| `get_journal` | Diário do período: operações e métricas de cada dia ou semana, e quais dias têm nota. |
| `get_daily_note` | Texto e imagens da nota diária de um dia específico. |

## Cadastros

| Ferramenta | O que faz |
| :-- | :-- |
| `list_accounts` | Contas de operação. |
| `list_assets` | Ativos cadastrados. |
| `list_tags` | Tags. |
| `list_tag_categories` | Categorias de tags. |
| `list_strategies` | Estratégias. |
| `get_active_plan` | Plano da assinatura e limites correspondentes. |
| `list_assist_context` | Contexto salvo do assistente. |

## Escrita

Disponíveis apenas com o escopo `trades:write`.

| Ferramenta | O que faz |
| :-- | :-- |
| `create_trade` | Registra uma nova operação. |
| `update_trade` | Edita uma operação existente, inclusive a anotação. |
| `delete_trade` | Exclui uma operação. |
| `create_asset` | Cadastra um ativo. |
| `create_tag` | Cria uma tag. |
| `create_tag_category` | Cria uma categoria de tags. |
| `create_strategy` | Cadastra uma estratégia. |

> **Escrita é escrita de verdade:** Uma operação criada ou excluída pelo assistente altera os seus dados reais e aparece imediatamente no app. Bons clientes pedem confirmação antes de executar ações destrutivas, mas a responsabilidade final é sua.

## Anotações e imagens

O assistente lê as anotações de operações e as notas diárias como texto, com títulos, listas e negrito preservados. As imagens anexadas — prints de gráfico, por exemplo — são enviadas como imagens de verdade, então um cliente com visão consegue analisá-las junto com o texto. Cada imagem aparece no texto como `[imagem 1]`, `[imagem 2]` e assim por diante, para o assistente saber a qual trecho ela pertence.

- Até **4 imagens** por resposta. Se a nota tiver mais, o assistente é avisado de quantas ficaram de fora.
- As imagens são reduzidas antes do envio. Nenhum link de download sai do Path Trader.
- Ao reescrever uma anotação com `update_trade`, as imagens existentes **nunca são apagadas**: o assistente pode mudá-las de lugar, e as que ele não mencionar vão para o fim da nota. Para remover uma imagem, use o app.

> **Nem todo cliente mostra imagens ao modelo:** Claude e Cursor repassam as imagens ao modelo. Em clientes que só leem texto, o assistente continua vendo a anotação e sabe que existe uma imagem, mas não o conteúdo dela.

## Períodos e filtros

As ferramentas de análise aceitam períodos nomeados — hoje, esta semana, este mês, últimos 30 dias — ou um intervalo explícito de datas. Todos são calculados no fuso de São Paulo, igual ao produto. Contas de demonstração ficam de fora por padrão.

## Limites da conta continuam valendo

As ferramentas passam pelas mesmas regras do produto. Se o seu plano tem limite de operações por mês, uma tentativa de criar trade acima do limite é recusada com a mesma mensagem que apareceria na interface.

---

Página original: https://www.path-trader.com.br/docs/ia/mcp/ferramentas