Skip to main content
Glama

UPí — upCampo

by br.com.upcampo
OverviewDiscussionsAdmin

Produção da lavoura

consultar_producao
Read-only

Área, colheita e produtividade por safra, cultura, setor, talhão ou variedade. Produtividade (PRODUTIVIDADE*) já vem por hectare: sacas de 60 kg em grãos, arrobas de 15 kg nas demais. TIPO_COLHEITA vazio conta como grãos: o número está em sacas (sc/ha), mesmo sem UNIDADE_ABREVIADA. Arroba (@/ha) só quando TIPO_COLHEITA for Fardos ou a unidade vier "@". Em grãos, QTDE_REGISTROS_* vem vazio: a quantidade de romaneios está em consultar_pos_colheita, visão romaneios, com agrupar_por.

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

  • cultura: Produção consolidada por cultura. Filtros: safra, cultura, setor, talhao, variedade.

  • setor: Produção consolidada por setor. Filtros: safra, cultura, setor, talhao, variedade.

  • talhao: Produção por talhão — o grão mais detalhado. Filtros: safra, cultura, setor, talhao, variedade.

  • variedade: Produção consolidada por variedade. Filtros: safra, cultura, setor, talhao, variedade.

Quando "visao" não é informada, usa "talhao". 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
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: cultura, setor, talhao, variedade.
setorNoNome do setor. Vale nas visões: cultura, setor, talhao, variedade.
visaoNoQual recorte consultar. Padrão: talhao.
limiteNoMáximo de linhas devolvidas. Padrão 100, teto 500.
talhaoNoNome do talhão. Vale nas visões: cultura, setor, talhao, variedade.
culturaNoNome da cultura, ex.: "ALGODAO", "SOJA". Vale nas visões: cultura, setor, talhao, variedade.
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.
variedadeNoNome da variedade. Vale nas visões: cultura, setor, talhao, variedade.
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.

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. Changed12 schema fields changed
    • changedInput schema / properties / cultura / description
      Previous value: -"Nome da cultura, ex.: \"ALGODAO\", \"SOJA\". Vale nas visoes: cultura, setor, talhao, variedade."New value: +"Nome da cultura, ex.: \"ALGODAO\", \"SOJA\". Vale nas visões: cultura, setor, talhao, variedade."
    • 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 / safra / description
      Previous value: -"Nome da safra, ex.: \"2025/2026\". Use listar_safras para ver as disponiveis. Vale nas visoes: cultura, setor, talhao, variedade."New value: +"Nome da safra, ex.: \"2025/2026\". Use listar_safras para ver as disponíveis. Vale nas visões: cultura, setor, talhao, variedade."
    • changedInput schema / properties / setor / description
      Previous value: -"Nome do setor. Vale nas visoes: cultura, setor, talhao, variedade."New value: +"Nome do setor. Vale nas visões: cultura, setor, talhao, variedade."
    • changedInput schema / properties / talhao / description
      Previous value: -"Nome do talhao. Vale nas visoes: cultura, setor, talhao, variedade."New value: +"Nome do talhão. Vale nas visões: cultura, setor, talhao, variedade."
    • changedInput schema / properties / variedade / description
      Previous value: -"Nome da variedade. Vale nas visoes: cultura, setor, talhao, variedade."New value: +"Nome da variedade. Vale nas visões: cultura, setor, talhao, variedade."
    • changedInput schema / properties / visao / description
      Previous value: -"Qual recorte consultar. Padrao: talhao."New value: +"Qual recorte consultar. Padrão: talhao."
    • 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.6/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered. The description adds substantial domain behavior: unit semantics (sc/ha for grains, @/ha otherwise), the rule that empty TIPO_COLHEITA counts as grains, empty QTDE_REGISTROS_* in grains, and substring/case/accent-insensitive text matching. It does not discuss pagination edge cases beyond pular, keeping it at a 4.

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-loads the most decision-relevant semantic (productivity units) before the view table, and every block earns its place. It is dense and longer than average, but the structure (unit rules, view list, filter behavior, pagination) is scannable rather than padded.

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?

With an output schema present, return values need no explanation; the description covers the remaining gaps an agent needs – view semantics, filter matching, unit interpretation, total_disponivel, and pagination via pular/limite. Nothing material is missing for correct invocation.

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 coverage is 100%, so the baseline is 3, but the description adds value beyond the schema: the exact-value vs. substring filter distinction, the default visao, and the productivity-unit interpretation tied to filters. It largely restates the per-view applicability already present in the schema, so it stops short of 5.

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 resource and scope: production data (area, harvest, productivity) broken down by safra, cultura, setor, talhão or variedade, and explicitly routes romaneio counts to the sibling consultar_pos_colheita. An agent can distinguish it from the many other consultar_* tools without opening a 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?

Explicit guidance: default visao is talhao when omitted; call once with the final limit rather than re-querying; and romaneio quantities live in consultar_pos_colheita instead. Covers when-to-use, when-not, and named alternatives.

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