Referência de ferramentas MCP
Última atualização · Ver como markdown
Seu assistente de IA escolhe essas ferramentas para você, para que você não precise acioná-las manualmente. Use esta página para ver o que o assistente pode fazer e conferir o trabalho dele. Para a configuração, consulte Servidor AMMP MCP.
IDs e nomes
O AMMP usa IDs curtos (UIDs) que começam com uma letra para o tipo: O para organizações, G para grupos de ativos, A para ativos (usinas) e D para dispositivos, por exemplo D3N1P6RWM0. A maioria das ferramentas também aceita o nome de um local e faz a correspondência mesmo quando não estiver escrito exatamente igual.
Os horários usam ISO 8601 com deslocamento UTC, como 2026-10-01T00:00:00Z.
Encontre organizações, sites e dispositivos
| Ferramenta | O que retorna |
|---|---|
list_orgs | Organizações que sua conta pode acessar, incluindo suborganizações |
list_asset_groups | Grupos de ativos, com busca opcional por nome |
list_assets | Sites, filtrados por nome ou grupo, com localização, país e capacidade fotovoltaica (kWp) |
get_asset_detail | Fuso horário, tipo de rede, coordenadas, capacidade FV, PR esperado, perda modelada, inclinação, azimute e tags de uma usina |
list_devices | Inversores, medidores, baterias e geradores de um site, com modelo, fabricante, número de série, capacidade nominal e quando os dados chegaram pela última vez |
list_edge_xnodes | Gateways de dados de terceiros vinculados a um local (dataloggers AMMP Edge não são listados aqui) |
Séries temporais, KPIs e alertas
| Ferramenta | O que retorna |
|---|---|
query_time_series | Dados de potência, energia, bateria ou ambiente para uma ou mais usinas ou grupos |
get_kpis | KPIs para um ou mais sites ou grupos (veja os tipos de KPI abaixo) |
get_status | Status atual do alerta, uma linha por alerta |
query_device_data | Dados para um único inversor, medidor, sistema de baterias ou grupo gerador, em resolução de 5 ou 15 minutos |
Intervalos de tempo para query_time_series:
| Tipo de métrica | Intervalos disponíveis |
|---|---|
power | 15 minutos, 1 hora |
energy | 1 hora, 1 dia, 1 mês ou automático |
battery | 15 minutos, 1 hora |
environment | 5 minutos, 15 minutos, 1 hora, 1 dia ou automático |
Tipos de KPI para get_kpis:
| Tipo de KPI | Conteúdo |
|---|---|
pv_performance | Desempenho incluindo potência ou energia FV esperada, com base na correção meteorológica e na perda modelada da usina |
pv_yield_losses | Tempo de inatividade da rede e da usina, e a energia perdida em cada um |
loss_waterfall | Perdas divididas em inatividade, perdas de inversor, clipping, sujidade e curtailment, com a principal categoria de perda por período |
financial_impact | Resultados financeiros por hora, dia ou mês |
environmental_impact | Impacto ambiental por período |
time_of_operation | Tempo de operação diário |
Solicitações para muitos sites são executadas em páginas de 100 sites, portanto, uma pergunta sobre um portfólio inteiro requer algumas idas e voltas. Se alguns sites falharem, os outros ainda retornarão e as falhas voltarão como avisos.
Dados brutos do dispositivo
| Ferramenta | O que faz |
|---|---|
raw_data_schema | Lista os campos brutos disponíveis para os dispositivos de um site. O assistente chama isso primeiro. |
query_raw_data | Retorna valores brutos ou agregados para os campos e dispositivos escolhidos |
influx_query | Executa uma consulta InfluxQL avançada para uma organização, para casos que as ferramentas acima não cobrem |
Os dados brutos vêm em dois esquemas de nomenclatura: standard, o modelo de dados da AMMP que é o mesmo para todos os fornecedores, e source, os nomes dos campos usados pelo próprio sistema do fornecedor do dispositivo.
Acesso à Data API
| Ferramenta | O que faz |
|---|---|
list_endpoints | Lista todos os endpoints da AMMP Data API |
query_endpoint | Chama diretamente qualquer endpoint de leitura (GET) da Data API |
Resultados e exportações
Os resultados em tabela podem ser retornados de várias maneiras. O assistente geralmente escolhe, mas você pode solicitar um formato específico.
| Modo | Comportamento |
|---|---|
auto (padrão) | Resultados pequenos são retornados na íntegra; os grandes são armazenados e retornados como um resumo com linhas de amostra |
preview | Apenas nomes de colunas e algumas linhas de exemplo |
reference | Sempre armazena o resultado e retorna seu ID |
inline | Retorna todas as linhas, até um limite de tamanho |
download | Retorna um link de download temporário em CSV ou Parquet |
persist_result transforma um resultado armazenado em um link de download em CSV ou Parquet. Os resultados armazenados e os links de download são temporários.
Observação
Todas as ferramentas são somente leitura e retornam apenas dados que sua conta AMMP tem permissão para ver.