Referência de ferramentas do MCP - AppSignal Documentation

O AppSignal MCP expõe 23 ferramentas em oito áreas de produto: descoberta de apps, incidentes de erro, performance, Anomaly detection, Check-ins, logging, métricas e dashboards. Uma 24ª ferramenta, get_more_tools, permite que um agente peça capacidades adicionais ou envie feedback sobre como uma tarefa se saiu. Você não chama essas ferramentas diretamente. Você descreve o que quer no chat do seu agente, por exemplo: “quais actions estão mais lentas em produção agora?” O agente escolhe a ferramenta apropriada e preenche seus parâmetros. Esta referência existe para que você possa verificar se uma capacidade existe, e nomear um parâmetro quando o agente escolher o errado. Para exemplos de como essas ferramentas se combinam para uma tarefa, veja os workflows do AppSignal MCP.

Referência de ferramentas

A maioria das ferramentas recebe app_name e app_environment para identificar a aplicação alvo. Ambos são comparados sem diferenciar maiúsculas de minúsculas, então MyApp/Production e myapp/production resolvem para a mesma aplicação. Se o nome não corresponder a uma aplicação que você pode acessar, a ferramenta retorna um erro nomeando o que você pediu e sugerindo as correspondências mais próximas, para que o agente possa tentar novamente com um nome válido. Toda ferramenta também recebe uma string context para que o agente possa dizer por que está fazendo a chamada. Os agentes geralmente preenchem isso automaticamente, então as tabelas abaixo focam nos parâmetros específicos da tarefa. manage_trigger, manage_log_line_action e manage_check_in_trigger cobrem, cada uma, várias operações por trás de um parâmetro action obrigatório, então quais campos você precisa depende da ação que você passar. Nessas tabelas, sim (upsert) marca um campo obrigatório em todo upsert, e sim (create) um obrigatório apenas quando o upsert cria algo em vez de atualizá-lo.

Descoberta de apps

`get_applications`

Obtenha todas as aplicações do AppSignal às quais o usuário tem acesso. Retorna as aplicações no formato app_name/app_environment. Use isto primeiro para descobrir as aplicações disponíveis antes de chamar outras ferramentas. Nenhum parâmetro específico da tarefa além de context.

`get_app_resources`

Descubra os recursos disponíveis em uma aplicação do AppSignal — namespaces, dashboards, usuários, notificadores, fontes de log, log views, ações de log line, marcadores de deploy e uptime monitors. Particularmente útil ao configurar gatilhos, atribuir incidentes ou entender a estrutura de uma aplicação.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente (por exemplo, `production`, `staging`).
`sections`	não	Seções para obter: `users`, `notifiers`, `namespaces`, `dashboards`, `log_sources`, `log_line_actions`, `log_views`, `deploy_markers`, `uptime_monitors`. Retorna todas se não especificado.
`deploy_marker_namespace`	não	Mostra apenas os deploys neste namespace (por exemplo, `web`).
`deploy_marker_revision`	não	Mostra apenas os deploys com esta revisão. Um prefixo curto funciona (por exemplo, `a1b2c3d`).

A seção deploy_markers retorna até 100 deploys recentes, cada um com sua revisão completa e o intervalo de tempo em que esteve ativo. Restrinja com deploy_marker_namespace ou deploy_marker_revision. Para encontrar os erros que um deploy introduziu, passe sua revisão para get_exception_incidents com new_only: true. Sem new_only, você recebe todo erro reportado nesse deploy, incluindo erros vistos pela primeira vez em um deploy anterior. A seção uptime_monitors lista cada URL monitorada e suas configurações. O uptime em si não é armazenado — ele é calculado a partir de métricas, então consulte o counter uptime_monitor_error_count com get_metrics_timeseries para calculá-lo. Para um detalhamento por fase, consulte uptime_monitor_timing com uma tag phase. Veja tempo de requisição.

Check-ins

Estas duas ferramentas cobrem os mesmos monitors que o process monitoring: monitors cron, que esperam uma execução em um agendamento, e monitors heartbeat, que esperam um sinal contínuo.

`get_check_in_triggers`

Lista monitors de check-in (cron e heartbeat), ou inspeciona um monitor com suas execuções recentes. Use isto para ver quais jobs ou serviços agendados devem reportar, verificar se estão no prazo, ou encontrar o ID de um monitor antes de atualizá-lo.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`id`	não	Inspeciona um gatilho de check-in pelo ID. Retorna a configuração e as execuções recentes desse gatilho.
`identifier`	não	Inspeciona um gatilho de check-in pelo identifier, como `nightly-export`.
`kind`	não	Filtra a lista de gatilhos por tipo: `cron` ou `heartbeat`. Ignorado quando `id` ou `identifier` é fornecido.
`state`	não	Filtra as execuções recentes de um gatilho por estado: `new`, `started`, `finished`, `missed`, `late` ou `unexpected`.
`page`	não	Número da página (começando em 1, padrão 1). Pagina a lista de gatilhos ou o histórico de execuções de um gatilho.

`manage_check_in_trigger`

Cria, atualiza ou exclui um monitor de check-in. Diferente dos gatilhos de Anomaly detection, os monitors de check-in são atualizados no lugar. Quando você atualiza um, os campos omitidos mantêm seus valores atuais.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`action`	sim	`upsert` para criar ou atualizar, ou `delete` para remover um monitor.
`id`	sim (`delete`)	ID de um monitor existente. Em `delete`, obrigatório a menos que você passe `identifier`. Em `upsert`, atualiza esse monitor.
`identifier`	sim (criação)	Identifier legível para humanos, como `nightly-export`. Também pode ser usado para localizar ou excluir um monitor existente.
`kind`	sim (criação)	`cron` ou `heartbeat`.
`syntax`	sim (cron)	Expressão cron, como `0 0 * * *`. Obrigatória sempre que o `kind` do monitor for `cron`, incluindo quando uma atualização muda para `cron`.
`wait_time_minutes`	sim (criação)	Período de tolerância antes que uma execução seja marcada como perdida.
`timezone`	não	Fuso horário para uma expressão cron. Padrão `UTC` na criação.
`description`	não	Descrição do que o monitor acompanha.
`notifier_ids`	não	IDs de notificadores para alertar quando um check-in é perdido ou atrasado. Use `get_app_resources(sections: ["notifiers"])`.

Incidentes de erro

`get_exception_incidents`

Liste e pesquise exceções e erros do AppSignal. Use isto para obter uma visão geral de exceções recentes, pesquisar em um período de tempo, encontrar incidentes por estado, ou verificar quais incidentes precisam de atenção. Retorna 50 incidentes por página.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`namespaces`	não	Lista separada por vírgulas de namespaces para filtrar (por exemplo, `web,background`).
`query`	não	Busca por palavra-chave sem diferenciar maiúsculas de minúsculas no nome da exceção e no nome da action. Suporta wildcards `*`.
`start`	não	Início do intervalo de tempo no formato ISO 8601. Padrão para o deploy mais recente se omitido.
`end`	não	Fim do intervalo de tempo no formato ISO 8601. Obrigatório se `start` for fornecido, a menos que `new_only` seja `true`.
`states`	não	Estados separados por vírgulas: `open`, `closed`, `wip`. Retorna todos os estados se não especificado.
`revision`	não	Restringe a um deploy específico. Use `"last"` para o deploy mais recente, ou passe um hash de revisão ou um prefixo curto. Ignorado quando `start` e `end` são fornecidos.
`new_only`	não	Quando `true`, retorna apenas os erros vistos pela primeira vez na janela, não todo erro ocorrido nela. Padrão `false`.
`page`	não	Número da página (começando em 1, padrão 1).
`per_page`	não	Número de incidentes por página. Padrão 50.

Para prompts que pedem ao seu agente por novos erros, veja Verificando o que um deploy quebrou.

`get_incident`

Obtenha informações detalhadas sobre um incidente do AppSignal. Retorna o estado atual, atribuição, primeira e última ocorrência, mensagens de erro, stack traces ou detalhes de alerta de anomalia. Suporta incidentes de exceção e anomalia.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`number`	sim	O ID numérico do incidente exibido nas URLs e listas do AppSignal.

`update_incidents`

Atualize incidentes em massa para uma aplicação do AppSignal. Use isto para alterar o estado do incidente, atualizar a severidade ou atribuir e desatribuir membros da equipe em vários incidentes de uma vez. Use get_app_resources com sections: ["users"] para encontrar IDs de usuários para atribuição.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`incidents`	não	Lista de números de incidentes para atualizar (por exemplo, `[123, 456, 789]`).
`state`	não	`open`, `closed` ou `wip` (work in progress).
`severity`	não	`critical`, `high`, `low`, `none`, `informational` ou `untriaged`.
`assign_users`	não	Lista de IDs de usuários para atribuir como responsáveis.
`unassign_users`	não	Lista de IDs de usuários para remover do incidente.

`manage_note`

Crie ou atualize uma nota em um incidente do AppSignal ou em uma trace action de performance. Markdown é suportado. Use isto para adicionar comentários, atualizações de status, descobertas de investigação ou passos de resolução. Identifique o alvo com number para um incidente, ou com namespace e action_name para uma trace action de performance. Informar os dois retorna um erro. Uma nota em uma trace action de performance é compartilhada por todos os traces dessa action. Ela permanece depois que os dados de trace da action expiram. Uma nota em um incidente de performance é armazenada na trace action do incidente, não no incidente. Ela permanece disponível depois que o incidente é fechado. Veja a documentação da página de traces para saber onde essas notas aparecem. Inclua uma URL completa de issue do GitHub em uma nota de incidente para vincular essa issue ao incidente. Isso requer que o app tenha o GitHub configurado. A vinculação ao GitHub não se aplica a notas em trace actions.

Esta ferramenta era anteriormente chamada de manage_incident_note, e antes disso de create_incident_note. Ambos os nomes antigos ainda funcionam como aliases, então prompts e configurações existentes continuam funcionando.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`number`	sim (incidente)	O ID numérico do incidente. Não pode ser combinado com `namespace` ou `action_name`.
`namespace`	sim (trace action)	O namespace da trace action de performance (por exemplo, `web`, `background`). Requer `action_name`.
`action_name`	sim (trace action)	O nome da action (por exemplo, `BlogPostsController#index`). Requer `namespace`.
`content`	sim	Conteúdo da nota. Formatação Markdown é suportada.
`id`	não	ID de uma nota existente para atualizar. Omita para criar uma nova nota. Você só pode editar notas que criou.

Performance

Para adicionar uma nota a uma trace action de performance, use o manage_note.

`get_performance`

Visão geral de performance: traces de performance baseados em amostras e actions lentas a partir de traces. Para apps padrão de Ruby e Elixir, retorna traces de performance baseados em amostras. Para apps que também enviam traces do OpenTelemetry, retorna adicionalmente uma lista ranqueada de actions com duração média, throughput e taxa de erro. Apps em migração para OpenTelemetry podem retornar ambos. Ferramentas de acompanhamento: use get_incident para inspecionar um incidente de performance específico, get_traces para puxar traces para uma action lenta, e update_incidents para alterar estado, severidade ou responsáveis.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`namespaces`	não	Namespaces separados por vírgula. Aplica-se a traces de performance e a actions OpenTelemetry.
`start`	não	Início do intervalo de tempo no formato ISO 8601. Padrão para o deploy mais recente em traces baseados em amostras, ou 24 horas atrás para actions OpenTelemetry.
`end`	não	Fim do intervalo de tempo no formato ISO 8601. Obrigatório se `start` for fornecido.
`states`	não	Estados separados por vírgula: `open`, `closed`, `wip`. Aplica-se apenas a incidentes baseados em amostras.
`revision`	não	Escopa para um deploy específico. Use `"last"` para o deploy mais recente, ou passe um hash de revisão. Ignorado quando `start`/`end` é fornecido. Use `get_app_resources(sections: ["deploy_markers"])` para listar revisões disponíveis.
`page`	não	Número da página para incidentes baseados em amostras (começando em 1, padrão 1). Actions OpenTelemetry são retornadas como uma lista ranqueada completa.
`per_page`	não	Número de incidentes por página (padrão 50). Pagina apenas incidentes baseados em amostras.

`get_traces`

Consulte traces de performance e erro, inspecione árvores de spans e visualize detalhes de spans. Suporta dois tipos de trace:

Performance traces — identificados por namespace e action_name. Use-os para investigar requisições lentas.
Error traces — identificados por digest. Obtenha o digest a partir de get_incident ou get_exception_incidents, depois use-o aqui para ver os traces de erro reais.

Cada tipo de trace suporta três modos:

Modo de lista — encontre traces e obtenha IDs de trace. Forneça namespace + action_name, ou digest.
Modo de árvore — passe um trace_id para ver todos os spans como uma árvore compacta, junto com os metadados do span raiz e uma quebra de duração. A quebra reporta o self time por categoria: no que os spans de cada categoria gastaram tempo trabalhando, em vez de esperar por um filho.
Modo de detalhe de span — passe trace_id e span_id para atributos completos do span, eventos e informações de recurso. Valores de atributo longos são truncados em 500 caracteres. O texto de queries de banco de dados é a exceção, e vem por completo até 10.000 caracteres.

O fluxo típico é: listar traces → inspecionar uma árvore de trace → investigar um span.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`namespace`	sim (performance)	O namespace para pesquisar (por exemplo, `web`, `background`). Não é necessário para error traces.
`action_name`	sim (performance)	O nome da action (por exemplo, `BlogPostsController#index`). Não é necessário para error traces.
`digest`	sim (erro)	O digest do incidente de exceção. Alterna para modo de error trace. Não pode ser combinado com `namespace` ou `action_name`.
`trace_id`	não	Alterna para modo de árvore. Retorna todos os spans deste trace.
`span_id`	não	Alterna para modo de detalhe de span. Requer `trace_id`.
`include_sensitive`	não	No modo de detalhe de span, inclui headers HTTP, ambiente da requisição, parâmetros da requisição e dados de sessão. Padrão `false`.
`start`	não	Início do intervalo de tempo no formato ISO 8601. Padrão para 24 horas atrás. Apenas performance traces.
`end`	não	Fim do intervalo de tempo no formato ISO 8601. Padrão para agora. Apenas performance traces.
`min_duration_ms`	não	Filtra para traces mais lentos do que este limite em milissegundos. Apenas modo de lista.
`limit`	não	Número máximo de traces a retornar (1–100, padrão 25). Apenas modo de lista.

Anomaly detection

`get_anomaly_incidents`

Liste e pesquise alertas de Anomaly detection do AppSignal. Retorna 50 alertas por página, incluindo timestamps e valores para cada alerta.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`state`	não	`open`, `closed`, `warmup`, `cooldown` ou `archived`. Retorna todos os estados se não especificado.
`trigger_id`	não	Filtra para incidentes de um gatilho específico. Use `get_triggers` para encontrar IDs de gatilhos.
`page`	não	Número da página (começando em 1, padrão 1).
`per_page`	não	Número de alertas por página. Padrão 50.

`get_triggers`

Liste gatilhos de Anomaly detection para uma aplicação do AppSignal. Retorna gatilhos ativos (não arquivados) com sua configuração completa — condições, notificadores e links de dashboard. Use isto para encontrar IDs de gatilhos antes de chamar manage_trigger.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`metric_name`	não	Filtra pelo nome da métrica (por exemplo, `response_time`, `error_rate`).
`kind`	não	Filtra pelo tipo de gatilho.
`tags`	não	Filtra por tags, por exemplo, `[{"key": "hostname", "value": "web-1"}]`.
`page`	não	Número da página (começando em 1, padrão 1).

`manage_trigger`

Cria, atualiza ou arquiva um gatilho de Anomaly detection. Os gatilhos são imutáveis. Quando você atualiza um gatilho, o AppSignal arquiva o existente, fechando todos os seus alertas e incidentes, e cria um substituto. Forneça todos os campos tanto para operações de criação quanto de atualização. Use get_metric_names e get_metric_tags para descobrir métricas e campos disponíveis. Use get_app_resources(sections: ["notifiers"]) para encontrar IDs de notificadores.

Esta ferramenta substitui o antigo fluxo archive_trigger. O nome antigo ainda funciona como um alias de compatibilidade retroativa, mas manage_trigger é a ferramenta principal.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`action`	sim	`upsert` para criar ou atualizar, ou `archive` para parar o monitoramento e fechar os alertas e incidentes associados.
`metric_name`	sim (`upsert`)	A métrica que este gatilho monitora.
`kind`	sim (`upsert`)	Tipo de gatilho. Use `"Advanced"` para métricas personalizadas.
`field`	sim (`upsert`)	Campo da métrica para comparar: `gauge`, `mean`, `p90`, `p95`, `counter` ou `count`.
`condition_value`	sim (`upsert`)	Valor do limite (por exemplo, `500.0` para “tempo de resposta > 500ms”).
`comparison_operator`	sim (`upsert`)	`<`, `>`, `<=`, `>=`, `==` ou `!=`.
`warmup_duration`	sim (`upsert`)	Minutos em que a condição deve ser atendida antes de um alerta ser aberto. Use `0` para imediato.
`cooldown_duration`	sim (`upsert`)	Minutos em que a condição não deve mais ser atendida antes de um alerta ser fechado.
`id`	sim (`archive`) / não (`upsert`)	ID de um gatilho existente. Obrigatório para `archive`. Em `upsert`, informá-lo arquiva o gatilho antigo e cria um novo.
`notifier_ids`	não	IDs de notificadores para os quais enviar alertas.
`tags`	não	Filtros de tag para escopar quais métricas são incluídas. Suporta wildcards (`*`).
`name`	não	Nome de exibição. Padrão para o nome da métrica se não fornecido.
`description`	não	Descrição do que este gatilho monitora e o que fazer quando ele dispara.
`dashboard_id`	não	ID do dashboard para vincular em notificações.
`no_match_is_zero`	não	Se true, trata dados de métrica ausentes como 0. Útil para counters que podem não reportar quando ociosos.
`format`	não	Formato dos dados da métrica (por exemplo, `duration`, `size`, `percent`).
`format_input`	não	Tamanho de entrada quando `format` é `size` (por exemplo, `kilobyte` ou `megabyte`).

Logging

`get_log_lines`

Consulte linhas de log usando a sintaxe de expressão do AppSignal. Suporta correspondência exata, contém, negação, comparações numéricas, lógica booleana e atributos aninhados. Retorna até 100 linhas por chamada, mais recentes primeiro por padrão. Para intervalos de tempo grandes, divida em várias chamadas e itere para frente. Cada linha é encabeçada por uma prévia de 120 caracteres da mensagem. Quando a mensagem é mais longa que isso, a resposta adiciona uma linha Message separada com o texto completo, limitado a 2.000 caracteres. Sintaxe de consulta:

Padrão	Exemplo
Correspondência exata	`severity=error`
Contém	`message:timeout`
Não contém	`message!:debug`
Diferente de	`hostname!=web-1`
Comparação numérica	`duration>100`
Lógica booleana	`severity=error AND (hostname=web-1 OR hostname=web-2)`
Valores entre aspas	`group="background jobs"`
Atributos aninhados	`user.id=123`

Campos disponíveis: severity, hostname, group, message, e quaisquer atributos personalizados.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`query`	sim	Consulta de expressão. Use uma string vazia para obter todos os logs.
`source_ids`	não	IDs de fontes de log para consultar. Consulta todas as fontes se não especificado. Use `get_app_resources(sections: ["log_sources"])` para encontrar IDs.
`start`	não	Início do intervalo de tempo no formato ISO 8601. Padrão para uma janela de consulta atrás.
`end`	não	Fim do intervalo de tempo no formato ISO 8601. Padrão para agora.
`limit`	não	Número de linhas de log para retornar (1–100, padrão 50).
`order`	não	`desc` (mais recente primeiro, padrão) ou `asc` (mais antigo primeiro).

`manage_log_line_action`

Cria, atualiza, reordena ou exclui uma ação de log line. As ações de log line são executadas durante a ingestão de logs, na ordem que você definir. Existem três tipos:

filter — descarta as linhas de log correspondentes para que nunca sejam armazenadas ou processadas posteriormente
trigger — dispara alertas e incidentes quando a query corresponde
metrics — extrai métricas de counter, gauge ou distribution das linhas de log correspondentes

A ordem de execução importa: se um filtro descartar uma linha de log, as ações subsequentes nunca a verão. Um padrão comum é colocar ações de métrica e gatilho antes de qualquer ação de filtro. Novas ações são adicionadas no final da ordem de execução.

Esta ferramenta substitui os antigos fluxos reorder_log_line_actions e delete_log_line_action. Esses nomes ainda funcionam como aliases de compatibilidade retroativa, mas manage_log_line_action é a ferramenta principal.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`action`	sim	`upsert` para criar ou atualizar, `reorder` para alterar a ordem de execução, ou `delete` para remover uma ação.
`name`	sim (criação)	Nome da ação (por exemplo, `"Drop health checks"`, `"Track error count"`).
`query`	sim (criação)	Expressão de query para corresponder às linhas de log.
`action_type`	sim (criação)	`filter`, `trigger` ou `metrics`. Não pode ser alterado em uma atualização.
`id`	sim (`delete`)	ID de uma ação existente. Em `upsert`, informá-lo atualiza essa ação em vez de criar uma nova.
`source_ids`	não	IDs de fontes de log às quais esta ação se aplica. Aplica-se a todas as fontes se não especificado.
`log_line_metrics`	não	Definições de métrica para extrair. Obrigatório ao criar uma ação `metrics`. Cada métrica requer `name` e `metric_type` (`counter`, `gauge` ou `distribution`). `gauge` e `distribution` também requerem um `field` do qual extrair o valor. Ao atualizar, substitui todas as definições de métrica existentes.
`action_ids`	sim (`reorder`)	Lista ordenada de IDs de ação. Quaisquer IDs de ação não incluídos são adicionados no final em sua ordem relativa atual.

Métricas

`discover_metrics`

Descubra categorias de métricas disponíveis e suas métricas para monitoramento. Use isto para obter uma visão geral do que pode monitorar, ou para investigar uma categoria específica. Também aceita uma referência dashboard:<dashboard_id> para mostrar métricas usadas em um dashboard específico.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`metric_subject`	não	Nome da categoria de métrica (por exemplo, `performance_metrics`, `host_metrics`) ou `dashboard:<dashboard_id>`.

`get_metric_names`

Obtenha os nomes de todas as métricas para a aplicação fornecida. Retorna os nomes das métricas como uma string separada por vírgulas. Use-os como entrada para get_metric_tags, get_metrics_timeseries e get_metrics_list.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.

`get_metric_tags`

Obtenha as tags e o tipo de métrica (Gauge, Counter, etc.) para uma métrica específica. Use os resultados para construir queries válidas com get_metrics_timeseries e get_metrics_list.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`metric_name`	sim	Nome da métrica. Use `get_metric_names` para encontrar métricas disponíveis.

`get_metrics_timeseries`

Obtenha uma timeseries para uma métrica na aplicação fornecida. Retorna dados ponto a ponto para um determinado intervalo de tempo, tipo de métrica e combinação de tags. Os valores de tag suportam correspondência por wildcard com *.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`metric_name`	sim	Nome da métrica.
`metric_type`	sim	`count`, `counter`, `gauge`, `mean`, `p90` ou `p95`. Use `get_metric_tags` para encontrar o tipo válido.
`start`	sim	Início do intervalo de tempo no formato ISO 8601.
`end`	sim	Fim do intervalo de tempo no formato ISO 8601.
`tags`	não	Filtros de tag, por exemplo, `[{"key": "hostname", "value": "web"}]`. Suporta wildcards ``.

`get_metrics_list`

Obtenha um valor agregado para uma métrica em um intervalo de tempo. Retorna um único valor agregado em vez de uma timeseries ponto a ponto. Útil para visões de resumo.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`metric_name`	sim	Nome da métrica.
`metric_type`	sim	`count`, `counter`, `gauge`, `mean`, `p90` ou `p95`.
`start`	sim	Início do intervalo de tempo no formato ISO 8601.
`end`	sim	Fim do intervalo de tempo no formato ISO 8601.
`tags`	não	Filtros de tag, por exemplo, `[{"key": "hostname", "value": "frontend1"}]`.

Dashboards

`manage_dashboard`

Crie ou atualize um dashboard do AppSignal. Esta ferramenta gerencia apenas os metadados do dashboard (título e descrição). Use create_dashboard_visual e update_dashboard_visual para adicionar gráficos. O MCP adiciona e atualiza, mas não remove. Para excluir um gráfico ou um dashboard inteiro, abra os dashboards da sua aplicação no AppSignal.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`title`	sim	Título do dashboard.
`description`	não	Descrição do propósito e do conteúdo do dashboard.
`id`	não	ID do dashboard para atualizar um dashboard existente. Omita para criar um novo.

`create_dashboard_visual`

Adicione um novo gráfico a um dashboard existente. Há dois tipos de visual disponíveis:

timeseries (padrão) — um gráfico de linha ou área que plota uma ou mais métricas ao longo do tempo.
number — um tile Big Number mostrando uma única métrica agregada, útil para um total, a leitura mais recente ou uma média rápida.

Ambos são renderizados exatamente como se você os tivesse construído no construtor de gráficos. Para saber para que serve cada tipo de gráfico, veja tipos de gráfico do dashboard. Use discover_metrics ou get_metrics_list para encontrar métricas disponíveis primeiro. Estes parâmetros se aplicam a ambos os tipos de visual:

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`dashboard_id`	sim	ID do dashboard ao qual adicionar o visual.
`title`	sim	Título do gráfico.
`type`	não	`timeseries` (padrão) ou `number`.
`description`	não	Contexto adicional sobre o visual.
`format`	não	Formato do valor: `number`, `percent`, `duration`, `throughput` ou `size`.
`format_input`	não	Unidade do valor de entrada: `bit`, `byte`, `kilobit`, `kilobyte` ou `megabyte`. Aplica-se apenas quando `format` é `size`.

Estes parâmetros se aplicam apenas a visuais timeseries:

Parâmetro	Obrigatório	Descrição
`metrics`	sim	Array de métricas a plotar. Cada uma recebe `name`, `fields` (um array de objetos como `[{"field": "mean"}]`, onde o campo é `mean`, `p90`, `p95`, `count`, `gauge` ou `counter`) e, opcionalmente, `tags`.
`display`	não	`line` (padrão), `area` ou `area_relative`.
`line_label`	não	Rótulo personalizado para as linhas do gráfico. Suporta substituições `%name%`, `%field%` e `%tag%`.
`draw_null_as_zero`	não	Se deve desenhar pontos de dados ausentes como zero. Padrão: `false`.
`min_y_axis`	não	Valor mínimo do eixo Y.
`tags`	não	Tags globais aplicadas a cada métrica neste visual.

Estes parâmetros se aplicam apenas a visuais number:

Parâmetro	Obrigatório	Descrição
`metric`	sim	A única métrica a exibir. Recebe `name`, `field` (`mean`, `p90`, `p95`, `count`, `gauge` ou `counter`), `aggregate` (`max`, `min`, `avg`, `sum`, `first` ou `last`) e, opcionalmente, `tags`.

Um tile Big Number recebe uma métrica e uma agregação no intervalo de tempo selecionado do dashboard. Peça isso em linguagem natural:

Text

Add a Big Number chart to the "API Health" dashboard showing the mean
of request_latency_ms over the selected time range, formatted as a duration.

O agente traduz isso em uma chamada create_dashboard_visual:

{
  "app_name": "MyApp",
  "app_environment": "production",
  "dashboard_id": "<DASHBOARD_ID>",
  "title": "Mean request latency",
  "type": "number",
  "format": "duration",
  "metric": {
    "name": "request_latency_ms",
    "field": "mean",
    "aggregate": "avg"
  }
}

O MCP cria o visual; ele não ingere métricas. A métrica para a qual você aponta um gráfico já precisa estar fluindo para o AppSignal. Veja métricas personalizadas para saber como enviá-las da sua aplicação.

`update_dashboard_visual`

Atualize um gráfico existente em um dashboard. Isso funciona tanto para visuais timeseries quanto Big Number — o tipo é lido a partir do visual existente, então você não passa type. Todos os campos são opcionais, exceto os identificadores, e os campos não especificados mantêm seus valores atuais. Passar metrics ou metric substitui toda a definição de métrica naquele visual, em vez de mesclar com ela.

Parâmetro	Obrigatório	Descrição
`app_name`	sim	Nome da aplicação do AppSignal.
`app_environment`	sim	Ambiente.
`visual_id`	sim	ID do visual a atualizar.
`title`	não	Novo título.
`description`	não	Nova descrição. Defina como uma string vazia para removê-la.
`format`	não	Formato do valor: `number`, `percent`, `duration`, `throughput` ou `size`.
`format_input`	não	Unidade do valor de entrada: `bit`, `byte`, `kilobit`, `kilobyte` ou `megabyte`. Aplica-se apenas quando `format` é `size`.
`metrics`	não	Apenas visuais timeseries. Substitui todo o array de métricas.
`display`	não	Apenas visuais timeseries. `line`, `area` ou `area_relative`.
`line_label`	não	Apenas visuais timeseries. Suporta substituições `%name%`, `%field%` e `%tag%`.
`draw_null_as_zero`	não	Apenas visuais timeseries. Se deve desenhar pontos de dados ausentes como zero.
`min_y_axis`	não	Apenas visuais timeseries. Valor mínimo do eixo Y.
`tags`	não	Apenas visuais timeseries. Tags globais. Substitui as tags globais existentes se fornecido.
`metric`	não	Apenas visuais Big Number. Substitui toda a definição de métrica. Mesma forma que em `create_dashboard_visual`.

Ferramentas de leitura e escrita

Toda ferramenta ou apenas lê seus dados ou pode alterá-los, e o nome dela indica qual: as ferramentas get_ e discover_ só leem, enquanto as ferramentas create_, update_ e manage_ escrevem. A exclusão fica dentro das ferramentas manage_, em vez de ter ferramentas próprias: manage_log_line_action remove uma ação, manage_check_in_trigger remove um monitor, e manage_trigger arquiva um. É por essa divisão que os clientes MCP agrupam as ferramentas, para que você possa configurar no seu agente quais ferramentas permitir, quais aprovar caso a caso, e quais bloquear.

Permissões de token

Cada token MCP é limitado a aplicações específicas e às ferramentas que você expõe nesse token. Se você quiser uma configuração mais restrita para um agente, é aqui que você a limita. Por exemplo, você pode expor apenas get_applications, get_app_resources e get_exception_incidents para um agente de triagem de incidentes, ou get_log_lines e manage_log_line_action para trabalho de ingestão de logs. Você também pode configurar um token para expor automaticamente novas ferramentas conforme elas forem adicionadas depois. Para os passos de como criar um, veja Autenticação.

Faltando uma ferramenta?

Além das áreas de produto acima, o AppSignal MCP expõe o get_more_tools, uma ferramenta de descoberta e feedback. Ela cumpre duas funções:

Registrar um pedido de uma capacidade que você não conseguiu encontrar
Enviar feedback sobre como uma tarefa ou chamada de ferramenta se saiu

Ela não desbloqueia nenhuma ferramenta oculta hoje. Seu valor está no fato de que o pedido ou feedback é registrado na sua conta, para que a equipe do AppSignal possa ver onde os agentes esbarram em limitações. O get_more_tools recebe estes parâmetros:

Parâmetro	Obrigatório	Descrição
`context`	sim	Por que o agente está chamando a ferramenta. Apenas registro — não altera a resposta.
`description`	não	A capacidade que você procura, em linguagem natural. Registrada como um pedido de ferramenta, se fornecida.
`notes`	não	O que aconteceu, com detalhes suficientes para uma pessoa agir. Obrigatório ao enviar feedback.
`outcome`	não	Resultado opcional para feedback: `success`, `partial` ou `failed`.

A maioria dos agentes não vai usá-la por conta própria, então peça explicitamente: “Use a tool get_more_tools do AppSignal para pedir uma forma de exportar incidentes em massa para CSV.” Ou, quando uma tarefa funcionou parcialmente: “Use a tool get_more_tools do AppSignal para enviar feedback de que get_log_lines encontrou os logs certos, mas eu ainda precisei de um segundo passo para resumi-los.”

Esbarrou em uma limitação com o toolset atual? Peça ao seu agente para chamar o get_more_tools e depois poste o mesmo pedido na comunidade no Discord para que a equipe do AppSignal possa avaliá-lo.