UPí — upCampo

Ordens de serviço agrícolas

consultar_ordens_servico

Read-only

Ordens de serviço da lavoura: plantio, aplicação, adubação, colheita. Combustível e manutenção de máquina não entram aqui — são frota.

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

cabecalho: Uma linha por ordem: status, tipo de atividade, área e percentual executado. Filtros: safra, status, tipo_atividade, equipe, codigo (valor exato), aceita período.
talhoes: Talhões atendidos por cada ordem, com área e cultura. Filtros: safra, status, talhao, setor, codigo (valor exato), aceita período.
insumos: Produtos previstos e executados por ordem, com dose por hectare, valor e lote. Lote vem vazio quando o produto não é controlado por lote. Filtros: safra, status, produto, classe_produto, lote, codigo (valor exato), aceita período.
execucao: Cada execução lançada: data, área, horas, equipamento e operador. Filtros: safra, talhao, equipamento, operador, codigo (valor exato), aceita período.

Quando "visao" não é informada, usa "cabecalho". 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

Name	Required	Description
`lote`	No	Código do lote do produto. Vale nas visões: insumos.
`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: cabecalho, talhoes, insumos, execucao.
`setor`	No	Nome do setor. Vale nas visões: talhoes.
`visao`	No	Qual recorte consultar. Padrão: cabecalho.
`codigo`	No	Código da ordem de serviço. Vale nas visões: cabecalho, talhoes, insumos, execucao.
`equipe`	No	Equipe responsável. Vale nas visões: cabecalho.
`limite`	No	Máximo de linhas devolvidas. Padrão 100, teto 500.
`status`	No	Status da ordem. Casa por trecho: "Pendente", "Finaliz". Vale nas visões: cabecalho, talhoes, insumos.
`talhao`	No	Nome do talhão. Vale nas visões: talhoes, execucao.
`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.
`produto`	No	Nome do produto. Vale nas visões: insumos.
`operador`	No	Operador. Vale nas visões: execucao.
`data_final`	No	Fim do período, inclusive, em dd/mm/aaaa ou aaaa-mm-dd.
`equipamento`	No	Equipamento usado. Vale nas visões: execucao.
`data_inicial`	No	Início do período, em dd/mm/aaaa ou aaaa-mm-dd.
`classe_produto`	No	Classe do produto. Vale nas visões: insumos.
`tipo_atividade`	No	Tipo de atividade da ordem. Vale nas visões: cabecalho.

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.

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

Changed1 schema field changedSep 15, 2026

addedInput schema / properties / lote

Added value: +{
+  "description": "Código do lote do produto. Vale nas visões: insumos.",
+  "type": "string"
+}

Changed18 schema fields changedSep 13, 2026

changedInput schema / properties / classe_produto / description

Previous value: -"Classe do produto. Vale nas visoes: insumos."New value: +"Classe do produto. Vale nas visões: insumos."

changedInput schema / properties / codigo / description

Previous value: -"Codigo da ordem de servico. Vale nas visoes: cabecalho, talhoes, insumos, execucao."New value: +"Código da ordem de serviço. Vale nas visões: cabecalho, talhoes, insumos, execucao."

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

Previous value: -"Equipamento usado. Vale nas visoes: execucao."New value: +"Equipamento usado. Vale nas visões: execucao."

changedInput schema / properties / equipe / description

Previous value: -"Equipe responsavel. Vale nas visoes: cabecalho."New value: +"Equipe responsável. Vale nas visões: cabecalho."

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

Previous value: -"Operador. Vale nas visoes: execucao."New value: +"Operador. Vale nas visões: execucao."

changedInput schema / properties / produto / description

Previous value: -"Nome do produto. Vale nas visoes: insumos."New value: +"Nome do produto. Vale nas visões: insumos."

changedInput schema / properties / safra / description

Previous value: -"Nome da safra, ex.: \"2025/2026\". Use listar_safras para ver as disponiveis. Vale nas visoes: cabecalho, talhoes, insumos, execucao."New value: +"Nome da safra, ex.: \"2025/2026\". Use listar_safras para ver as disponíveis. Vale nas visões: cabecalho, talhoes, insumos, execucao."

changedInput schema / properties / setor / description

Previous value: -"Nome do setor. Vale nas visoes: talhoes."New value: +"Nome do setor. Vale nas visões: talhoes."

changedInput schema / properties / status / description

Previous value: -"Status da ordem. Casa por trecho: \"Pendente\", \"Finaliz\". Vale nas visoes: cabecalho, talhoes, insumos."New value: +"Status da ordem. Casa por trecho: \"Pendente\", \"Finaliz\". Vale nas visões: cabecalho, talhoes, insumos."

changedInput schema / properties / talhao / description

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

changedInput schema / properties / tipo_atividade / description

Previous value: -"Tipo de atividade da ordem. Vale nas visoes: cabecalho."New value: +"Tipo de atividade da ordem. Vale nas visões: cabecalho."

changedInput schema / properties / visao / description

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

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.8/5.0

Behavior5/5

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

Annotations only cover the safety profile (readOnlyHint, openWorldHint). The description goes well beyond: it discloses text-matching semantics (substring, case- and accent-insensitive, except exact-value filters), the meaning of 'total_disponivel', default visao, and pagination strategy. None of this is derivable from the annotations or schema alone.

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 scope and the frota exclusion, then uses a tight bulleted block for the visões. Some filter lists duplicate the schema's per-visao 'Vale nas visões' notes, which is redundant, but the structure keeps it scannable and nothing is padded prose.

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 18 optional params, full schema coverage, an output schema, and read-only annotations, the description supplies everything missing: visao selection, default behavior, filter semantics, total_disponivel, and the single-call/limit rule. An agent could call this correctly without further context.

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% and the schema already states per-visao parameter validity, so the baseline is 3. The description earns a notch more by adding matching semantics that change how parameters behave ('aplicacao' matches 'Aplicação'; exact-match params like codigo require the full value), which tells the agent how to format filter values.

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?

Opens with a specific resource and scope ('Ordens de serviço da lavoura: plantio, aplicação, adubação, colheita') and immediately carves out what does NOT belong ('Combustível e manutenção de máquina não entram aqui — são frota'). This distinguishes it from the sibling consultar_frota without the agent needing to open either 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?

Explicitly enumerates the four 'visao' modes with the rows and filters each returns, states the default when 'visao' is omitted, and names the negative case (frota tools). It also gives anti-pattern guidance ('Chame uma vez só... nunca repita a consulta mudando só o limite'), which is exactly the kind of behavioral routing an agent needs.

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?