UPí — upCampo

Pós-colheita

consultar_pos_colheita

Read-only

Romaneios de colheita e de saída, fardos de algodão, coletas e contratos — o documento que deu origem ao que entrou ou saiu do estoque. Para qualquer total — quantos romaneios, quanto pesou, quantas sacas, por talhão, por variedade, por mês — use "agrupar_por" nas visões romaneios, fardos e saidas: o banco soma. Nunca liste romaneios ou fardos para somar; a listagem traz no máximo 30 linhas e serve para ver documentos específicos. Pesos em kg. SACAS_LIQUIDAS = PESO_LIQUIDO_FINAL / 60 (saca de 60 kg); ARROBAS_FAZENDA = PESO_FAZENDA / 15. Produtividade por hectare vem de consultar_producao. Por talhão, agrupe por setor e talhao juntos: o mesmo nome de talhão pode existir em setores diferentes.

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

romaneios: Romaneios de colheita (grãos), com todos os descontos. Com agrupar_por: QTDE_LINHAS é o número de romaneios, ROMANEIOS_PESADOS os que já têm peso, e as somas de peso e sacas. Filtros: safra, cultura, talhao, setor, variedade, local_estoque, numero (valor exato), aceita período. Agrupa por: safra, cultura, setor, talhao, variedade, local_estoque, mes, produtor_terceiro. Lista no máximo 30 linhas por chamada.
saidas: Romaneios de saída: o que saiu da fazenda, para qual comprador e nota fiscal. Com agrupar_por: QTDE_LINHAS é o número de romaneios de saída. Filtros: safra, cultura, comprador, local_estoque, numero (valor exato), aceita período. Agrupa por: safra, cultura, produto, comprador, local_estoque, mes. Lista no máximo 30 linhas por chamada.
contratos: Contratos de venda: quantidade contratada, embarcada e saldo. Filtros: safra, cultura, entidade, situacao, numero (valor exato), aceita período.
fardos: Fardos de algodão. Consolidado da safra inteira: fardos_safra. Com agrupar_por: QTDE_LINHAS é o número de fardos, FARDOS_PESADOS os que já têm peso — as somas de peso só contam os pesados. Filtros: safra, cultura, talhao, setor, variedade, local_estoque, codigo (valor exato), status, aceita período. Agrupa por: safra, cultura, setor, talhao, variedade, local_estoque, mes, status, colheitadeira. Lista no máximo 30 linhas por chamada.
fardos_safra: Fardos consolidados por safra e cultura: peso, rendimento e contagem. Filtros: safra, cultura.
coletas: Coletas de fardos levados para a algodoeira. Filtros: safra, setor, algodoeira, status, aceita período. Lista no máximo 30 linhas por chamada.

Quando "visao" não é informada, usa "fardos_safra". 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. Para totais e contagens use "agrupar_por"; a listagem é limitada e serve para ver itens. Com "agrupar_por", a resposta vem somada pelo banco: uma linha por grupo, com QTDE_LINHAS, as somas e os maiores e menores valores (MAIOR_*, MENOR_*). Use isso em vez de somar linhas por conta própria.

Input Schema

TableJSON Schema

Name	Required	Description
`pular`	No	Linhas a pular, para ler um resultado grande em partes. Use com limite quando total_disponivel for maior que o que veio.
`safra`	No	Nome da safra, ex.: "2025/2026". Use listar_safras para ver as disponíveis. Vale nas visões: romaneios, saidas, contratos, fardos, fardos_safra, coletas.
`setor`	No	Nome do setor. Vale nas visões: romaneios, fardos, coletas.
`visao`	No	Qual recorte consultar. Padrão: fardos_safra.
`codigo`	No	Código do fardo. Vale nas visões: fardos.
`limite`	No	Máximo de linhas devolvidas. Padrão 100, teto 500.
`numero`	No	Número do romaneio. Vale nas visões: romaneios, saidas, contratos.
`status`	No	Status do fardo. Vale nas visões: fardos, coletas.
`talhao`	No	Nome do talhão. Vale nas visões: romaneios, fardos.
`cultura`	No	Nome da cultura, ex.: "ALGODAO", "SOJA". Vale nas visões: romaneios, saidas, contratos, fardos, fardos_safra.
`fazenda`	No	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.
`entidade`	No	Contraparte do contrato. Vale nas visões: contratos.
`situacao`	No	Situação do contrato. Vale nas visões: contratos.
`comprador`	No	Comprador. Vale nas visões: saidas.
`variedade`	No	Nome da variedade. Vale nas visões: romaneios, fardos.
`algodoeira`	No	Algodoeira de destino. Vale nas visões: coletas.
`data_final`	No	Fim do período, inclusive, em dd/mm/aaaa ou aaaa-mm-dd.
`agrupar_por`	No	Dimensões para somar no banco, em vez de listar linha a linha. Cada visão aceita só as dimensões listadas nela.
`data_inicial`	No	Início do período, em dd/mm/aaaa ou aaaa-mm-dd.
`local_estoque`	No	Local de estoque (armazém, silo) que recebeu. Vale nas visões: romaneios, saidas, fardos.

Output Schema

TableJSON Schema

Name	Required	Description
`total`	Yes	Linhas devolvidas nesta resposta.
`visao`	Yes
`avisos`	No	O que o servidor aplicou sem ser pedido, como um período padrão.
`linhas`	Yes
`fazenda`	Yes
`truncado`	Yes	true quando há mais linhas além das devolvidas.
`total_disponivel`	Yes	Quantas linhas o filtro encontra ao todo, qualquer que seja o limite pedido.
`filtros_ignorados`	Yes	Filtros que não existem na visão escolhida e por isso não foram aplicados.

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedSep 29, 2026

addedInput schema / properties / agrupar_por

Added value: +{
+  "description": "Dimensões para somar no banco, em vez de listar linha a linha. Cada visão aceita só as dimensões listadas nela.",
+  "items": {
+    "enum": [
+      "safra",
+      "cultura",
+      "setor",
+      "talhao",
+      "variedade",
+      "local_estoque",
+      "mes",
+      "produtor_terceiro",
+      "produto",
+      "comprador",
+      "status",
+      "colheitadeira"
+    ],
+    "type": "string"
+  },
+  "maxItems": 4,
+  "minItems": 1,
+  "type": "array"
+}

changedInput schema / properties / cultura / description

Previous value: -"Nome da cultura, ex.: \"ALGODAO\", \"SOJA\". Vale nas visões: romaneios, saidas, contratos, fardos_safra."New value: +"Nome da cultura, ex.: \"ALGODAO\", \"SOJA\". Vale nas visões: romaneios, saidas, contratos, fardos, fardos_safra."

addedInput schema / properties / local_estoque

Added value: +{
+  "description": "Local de estoque (armazém, silo) que recebeu. Vale nas visões: romaneios, saidas, fardos.",
+  "type": "string"
+}

changedInput schema / properties / variedade / description

Previous value: -"Nome da variedade. Vale nas visões: fardos."New value: +"Nome da variedade. Vale nas visões: romaneios, fardos."

Changed1 schema field changedSep 29, 2026

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."

Changed1 schema field changedSep 17, 2026

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"
+}

Changed19 schema fields changedSep 13, 2026

changedInput schema / properties / algodoeira / description

Previous value: -"Algodoeira de destino. Vale nas visoes: coletas."New value: +"Algodoeira de destino. Vale nas visões: coletas."

changedInput schema / properties / codigo / description

Previous value: -"Codigo do fardo. Vale nas visoes: fardos."New value: +"Código do fardo. Vale nas visões: fardos."

changedInput schema / properties / comprador / description

Previous value: -"Comprador. Vale nas visoes: saidas."New value: +"Comprador. Vale nas visões: saidas."

changedInput schema / properties / cultura / description

Previous value: -"Nome da cultura, ex.: \"ALGODAO\", \"SOJA\". Vale nas visoes: romaneios, saidas, contratos, fardos_safra."New value: +"Nome da cultura, ex.: \"ALGODAO\", \"SOJA\". Vale nas visões: romaneios, saidas, contratos, fardos_safra."

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 / entidade / description

Previous value: -"Contraparte do contrato. Vale nas visoes: contratos."New value: +"Contraparte do contrato. Vale nas visões: contratos."

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 / numero / description

Previous value: -"Numero do romaneio. Vale nas visoes: romaneios, saidas, contratos."New value: +"Número do romaneio. Vale nas visões: romaneios, saidas, contratos."

changedInput schema / properties / safra / description

Previous value: -"Nome da safra, ex.: \"2025/2026\". Use listar_safras para ver as disponiveis. Vale nas visoes: romaneios, saidas, contratos, fardos, fardos_safra, coletas."New value: +"Nome da safra, ex.: \"2025/2026\". Use listar_safras para ver as disponíveis. Vale nas visões: romaneios, saidas, contratos, fardos, fardos_safra, coletas."

changedInput schema / properties / setor / description

Previous value: -"Nome do setor. Vale nas visoes: romaneios, fardos, coletas."New value: +"Nome do setor. Vale nas visões: romaneios, fardos, coletas."

changedInput schema / properties / situacao / description

Previous value: -"Situacao do contrato. Vale nas visoes: contratos."New value: +"Situação do contrato. Vale nas visões: contratos."

changedInput schema / properties / status / description

Previous value: -"Status do fardo. Vale nas visoes: fardos, coletas."New value: +"Status do fardo. Vale nas visões: fardos, coletas."

changedInput schema / properties / talhao / description

Previous value: -"Nome do talhao. Vale nas visoes: romaneios, fardos."New value: +"Nome do talhão. Vale nas visões: romaneios, fardos."

changedInput schema / properties / variedade / description

Previous value: -"Nome da variedade. Vale nas visoes: fardos."New value: +"Nome da variedade. Vale nas visões: fardos."

changedInput schema / properties / visao / description

Previous value: -"Qual recorte consultar. Padrao: fardos_safra."New value: +"Qual recorte consultar. Padrão: fardos_safra."

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."

First observedSep 12, 2026

TDQS

A4.6/5.0

Behavior4/5

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

Annotations only declare readOnlyHint/openWorldHint; the description adds real behavioral context — 30-row listing caps, total_disponivel, partial (accent/case-insensitive) text matching vs exact-value filters, server-side summing with MAIOR_*/MENOR_* aggregates, and pagination via pular/limite. One caveat: it repeatedly asserts 'máximo 30 linhas por chamada' while the schema's limite allows up to 500, which is an internal tension an agent must reconcile.

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

Conciseness3/5

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

It is front-loaded well and dense with useful rules, but several statements are repeated nearly verbatim — the 30-row listing cap appears in four view bullets, and the 'use agrupar_por instead of summing' instruction is stated twice. The length is justified by complexity, yet the redundancy costs it a point.

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 20-parameter, six-mode tool with an output schema, the description covers intent routing, filters per view, aggregation semantics, unit conventions, defaults, and result-shape fields (QTDE_LINHAS, MAIOR_*, total_disponivel), so an agent can call it correctly on the first attempt.

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

Parameters5/5

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

Schema coverage is already 100%, but the description goes further: it documents per-view applicability of each filter and the exact set of agrupar_por dimensions each view accepts, plus the derived-metric formulas (SACAS_LIQUIDAS = PESO_LIQUIDO_FINAL/60, ARROBAS_FAZENDA = PESO_FAZENDA/15) and the advice to group by setor+talhao together.

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?

The opening enumerates exactly what the tool covers — romaneios de colheita/saída, fardos de algodão, coletas e contratos — and frames it as the originating documents of stock movement, which cleanly separates it from siblings like consultar_estoque and consultar_producao. The six views are named explicitly, so an agent can match an intent to the tool 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?

Explicit routing rules are given: use agrupar_por for any total, never list to sum, that the listing is capped and meant for inspecting specific documents, that productivity comes from consultar_producao, and that safra names come from listar_safras. It also states the default view when visao is omitted and that queries are single-farm, with instructions to omit fazenda unless the user names another.

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

All UPí — upCampo tools Inspect

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

Need Help?