Skip to main content
Glama

UPí — upCampo

by br.com.upcampo
OverviewDiscussionsAdmin

Monitoramento de pragas

consultar_monitoramento_pragas
Read-only

Levantamentos de campo: pragas encontradas, pontos monitorados e fenologia. Não confundir com aplicação de defensivo, que é ordem de serviço.

Visões disponíveis (parâmetro "visao"):

  • levantamentos: Cabeçalho de cada levantamento: data, talhão, quantos pontos e quem levantou. Filtros: safra, talhao, setor, cultura, aceita período.

  • ocorrencias: Praga por levantamento, com o resultado já calculado e a faixa de alerta. Filtros: safra, talhao, setor, praga, classificacao, aceita período.

  • pontos: Um registro por ponto monitorado: stand, altura, estágio e coordenada. Filtros: safra, talhao, setor, tecnico, aceita período.

  • fenologia: Fenologia medida no levantamento: stand, altura, nós, maçãs. Filtros: safra, talhao, setor, aceita período.

  • registros: A praga ponto a ponto, com o valor bruto anotado no campo. Filtros: safra, talhao, praga, aceita período.

Quando "visao" não é informada, usa "ocorrencias". Filtro de texto casa por trecho, sem diferenciar maiúsculas nem acento ("aplicacao" acha "Aplicação") — exceto os marcados "(valor exato)", que exigem o valor inteiro, como código, placa e número. A resposta traz "total_disponivel": quantas linhas o filtro encontra ao todo. Chame uma vez só, já com o limite que a resposta vai usar — nunca repita a consulta mudando só o limite; se só o número interessa e o total pode ser grande, um limite baixo basta.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pragaNoNome da praga. Vale nas visões: ocorrencias, registros.
pularNoLinhas a pular, para ler um resultado grande em partes. Use com limite quando total_disponivel for maior que o que veio.
safraNoNome da safra, ex.: "2025/2026". Use listar_safras para ver as disponíveis. Vale nas visões: levantamentos, ocorrencias, pontos, fenologia, registros.
setorNoNome do setor. Vale nas visões: levantamentos, ocorrencias, pontos, fenologia.
visaoNoQual recorte consultar. Padrão: ocorrencias.
limiteNoMáximo de linhas devolvidas. Padrão 100, teto 500.
talhaoNoNome do talhão. Vale nas visões: levantamentos, ocorrencias, pontos, fenologia, registros.
culturaNoNome da cultura, ex.: "ALGODAO", "SOJA". Vale nas visões: levantamentos.
fazendaNoNome da fazenda. Omita para usar a fazenda corrente do usuário — é o padrão, e é o que o usuário espera quando não cita nenhuma. Informe apenas quando ele nomear outra fazenda. Cada consulta trata de uma fazenda por vez.
tecnicoNoQuem fez o levantamento. Vale nas visões: pontos.
data_finalNoFim do período, inclusive, em dd/mm/aaaa ou aaaa-mm-dd.
data_inicialNoInício do período, em dd/mm/aaaa ou aaaa-mm-dd.
classificacaoNoClassificação da praga. Vale nas visões: ocorrencias.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
totalYesLinhas devolvidas nesta resposta.
visaoYes
avisosNoO que o servidor aplicou sem ser pedido, como um período padrão.
linhasYes
fazendaYes
truncadoYestrue quando há mais linhas além das devolvidas.
total_disponivelYesQuantas linhas o filtro encontra ao todo, qualquer que seja o limite pedido.
filtros_ignoradosYesFiltros que não existem na visão escolhida e por isso não foram aplicados.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / total_disponivel / description
      Previous value: -"Quantas linhas o filtro encontra ao todo. Para contar sem trazer os dados, chame com limite 1 e leia este campo."New value: +"Quantas linhas o filtro encontra ao todo, qualquer que seja o limite pedido."
  2. Changed1 schema field changed
    • addedOutput schema / properties / avisos
      Added value: +{
+  "description": "O que o servidor aplicou sem ser pedido, como um período padrão.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
  3. Changed14 schema fields changed
    • changedInput schema / properties / classificacao / description
      Previous value: -"Classificacao da praga. Vale nas visoes: ocorrencias."New value: +"Classificação da praga. Vale nas visões: ocorrencias."
    • changedInput schema / properties / cultura / description
      Previous value: -"Nome da cultura, ex.: \"ALGODAO\", \"SOJA\". Vale nas visoes: levantamentos."New value: +"Nome da cultura, ex.: \"ALGODAO\", \"SOJA\". Vale nas visões: levantamentos."
    • changedInput schema / properties / data_final / description
      Previous value: -"Fim do periodo, inclusive, em dd/mm/aaaa ou aaaa-mm-dd."New value: +"Fim do período, inclusive, em dd/mm/aaaa ou aaaa-mm-dd."
    • changedInput schema / properties / data_inicial / description
      Previous value: -"Inicio do periodo, em dd/mm/aaaa ou aaaa-mm-dd."New value: +"Início do período, em dd/mm/aaaa ou aaaa-mm-dd."
    • changedInput schema / properties / fazenda / description
      Previous value: -"Nome da fazenda. Omita para usar a fazenda corrente do usuario — e o padrao, e e o que o usuario espera quando nao cita nenhuma. Informe apenas quando ele nomear outra fazenda. Cada consulta trata de uma fazenda por vez."New value: +"Nome da fazenda. Omita para usar a fazenda corrente do usuário — é o padrão, e é o que o usuário espera quando não cita nenhuma. Informe apenas quando ele nomear outra fazenda. Cada consulta trata de uma fazenda por vez."
    • changedInput schema / properties / limite / description
      Previous value: -"Maximo de linhas devolvidas. Padrao 100, teto 500."New value: +"Máximo de linhas devolvidas. Padrão 100, teto 500."
    • changedInput schema / properties / praga / description
      Previous value: -"Nome da praga. Vale nas visoes: ocorrencias, registros."New value: +"Nome da praga. Vale nas visões: ocorrencias, registros."
    • changedInput schema / properties / safra / description
      Previous value: -"Nome da safra, ex.: \"2025/2026\". Use listar_safras para ver as disponiveis. Vale nas visoes: levantamentos, ocorrencias, pontos, fenologia, registros."New value: +"Nome da safra, ex.: \"2025/2026\". Use listar_safras para ver as disponíveis. Vale nas visões: levantamentos, ocorrencias, pontos, fenologia, registros."
    • changedInput schema / properties / setor / description
      Previous value: -"Nome do setor. Vale nas visoes: levantamentos, ocorrencias, pontos, fenologia."New value: +"Nome do setor. Vale nas visões: levantamentos, ocorrencias, pontos, fenologia."
    • changedInput schema / properties / talhao / description
      Previous value: -"Nome do talhao. Vale nas visoes: levantamentos, ocorrencias, pontos, fenologia, registros."New value: +"Nome do talhão. Vale nas visões: levantamentos, ocorrencias, pontos, fenologia, registros."
    • changedInput schema / properties / tecnico / description
      Previous value: -"Quem fez o levantamento. Vale nas visoes: pontos."New value: +"Quem fez o levantamento. Vale nas visões: pontos."
    • changedInput schema / properties / visao / description
      Previous value: -"Qual recorte consultar. Padrao: ocorrencias."New value: +"Qual recorte consultar. Padrão: ocorrencias."
    • changedOutput schema / properties / filtros_ignorados / description
      Previous value: -"Filtros que nao existem na visao escolhida e por isso nao foram aplicados."New value: +"Filtros que não existem na visão escolhida e por isso não foram aplicados."
    • changedOutput schema / properties / truncado / description
      Previous value: -"true quando ha mais linhas alem das devolvidas."New value: +"true quando há mais linhas além das devolvidas."
  4. First observed

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover read-only/no-open-world, but the description adds real behavioral context beyond them: default visao, case- and accent-insensitive partial text matching versus exact-value filters, the presence of total_disponivel in the response, and pagination strategy via pular/limite. This is unusually rich disclosure for a query tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose and exclusion, then an efficient bulleted breakdown per view, then filtering/limit rules. Length is justified by 13 parameters and 5 views, though a few lines restate schema-documented view applicability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 13-parameter, multi-view query tool with an output schema present, the description covers defaults, filter behavior, pagination, and response metadata (total_disponivel) so an agent can invoke it correctly in one shot with the right limit.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is already 100% and documents per-view applicability of each filter, so the description mostly parallels it; however it adds genuine value by explaining the default visao and the text-matching semantics (partial vs exact) that the schema does not state.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (field survey of pests found, monitored points, phenology) and explicitly distinguishes itself from the sibling domain of pesticide application (consultar_ordens_servico). An agent can tell what this tool returns and what it is not without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use guidance per view (levantamentos, ocorrencias, pontos, fenologia, registros) with the applicable filters for each, states the default view (ocorrencias), points to listar_safras for valid safra values, and routes the agent away from pesticide application. Also instructs calling once with the intended limit rather than re-querying.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All UPí — upCampo toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources