UPí — upCampo

Frota e manutenção

consultar_frota

Read-only

Máquinas e veículos: cadastro, abastecimento, ordens de manutenção, planos e custos. Ordem de manutenção é coisa distinta de ordem de serviço agrícola.

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

cadastro: Cadastro dos equipamentos, com horímetro atual. Inclui equipamento de terceiro: para a frota própria, filtre propriedade e subtipo. Filtros: equipamento, codigo (valor exato), placa (valor exato), tipo_equipamento, subtipo, propriedade, ativo, setor.
abastecimento: Abastecimentos lançados: litros, preço, horímetro e consumo. Filtros: equipamento, placa (valor exato), combustivel, operador, local_estoque, aceita período.
ordens: Ordens de manutenção: serviço, status, valor e horímetro de geração. O que decide se a ordem está pendente é o STATUS, nunca a data: há ordem pendente com DATA_FINALIZACAO preenchida, as vezes anterior a própria data da ordem. Trate essa data como confiável só quando o status for Finalizado. Filtros: equipamento, status, tipo, grupo_manutencao, aceita período.
planos: Planos de manutenção preventiva e o que está por vencer. Filtros: equipamento, plano, status.
custos: Custos lançados por equipamento: peças, serviços e combustível. Filtros: equipamento, categoria, fornecedor, aceita período.
checklists: Checklists preenchidos por equipamento. Filtros: equipamento, status, aceita período.

Quando "visao" não é informada, usa "cadastro". 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
`tipo`	No	Tipo da ordem. Casa por trecho: "Preventiva" acha "Manutencao Preventiva". Vale nas visões: ordens.
`ativo`	No	true traz só os equipamentos ativos. Vale nas visões: cadastro.
`placa`	No	Placa do veículo. Vale nas visões: cadastro, abastecimento.
`plano`	No	Nome do plano. Vale nas visões: planos.
`pular`	No	Linhas a pular, para ler um resultado grande em partes. Use com limite quando total_disponivel for maior que o que veio.
`setor`	No	Nome do setor. Vale nas visões: cadastro.
`visao`	No	Qual recorte consultar. Padrão: cadastro.
`codigo`	No	Código do equipamento. Vale nas visões: cadastro.
`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: ordens, planos, checklists.
`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.
`subtipo`	No	Subtipo do cadastro. "Frota" é a frota de máquinas; terceirizados costumam vir com outro subtipo. Vale nas visões: cadastro.
`operador`	No	Operador. Vale nas visões: abastecimento.
`categoria`	No	Categoria do custo. Vale nas visões: custos.
`data_final`	No	Fim do período, inclusive, em dd/mm/aaaa ou aaaa-mm-dd.
`fornecedor`	No	Fornecedor. Vale nas visões: custos.
`combustivel`	No	Combustivel. Vale nas visões: abastecimento.
`equipamento`	No	Descrição do equipamento. Vale nas visões: cadastro, abastecimento, ordens, planos, custos, checklists.
`propriedade`	No	Se o equipamento é próprio ou de terceiro. Use para separar a frota da fazenda dos caminhões de terceiros que só aparecem no carregamento. Vale nas visões: cadastro.
`data_inicial`	No	Início do período, em dd/mm/aaaa ou aaaa-mm-dd.
`local_estoque`	No	Local de estoque / posto. Vale nas visões: abastecimento.
`grupo_manutencao`	No	Grupo de manutenção. Vale nas visões: ordens.
`tipo_equipamento`	No	Tipo do equipamento. Vale nas visões: cadastro.

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

Changed24 schema fields changedSep 13, 2026

changedInput schema / properties / ativo / description

Previous value: -"true traz so os equipamentos ativos. Vale nas visoes: cadastro."New value: +"true traz só os equipamentos ativos. Vale nas visões: cadastro."

changedInput schema / properties / categoria / description

Previous value: -"Categoria do custo. Vale nas visoes: custos."New value: +"Categoria do custo. Vale nas visões: custos."

changedInput schema / properties / codigo / description

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

changedInput schema / properties / combustivel / description

Previous value: -"Combustivel. Vale nas visoes: abastecimento."New value: +"Combustivel. Vale nas visões: abastecimento."

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: -"Descricao do equipamento. Vale nas visoes: cadastro, abastecimento, ordens, planos, custos, checklists."New value: +"Descrição do equipamento. Vale nas visões: cadastro, abastecimento, ordens, planos, custos, checklists."

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

Previous value: -"Fornecedor. Vale nas visoes: custos."New value: +"Fornecedor. Vale nas visões: custos."

changedInput schema / properties / grupo_manutencao / description

Previous value: -"Grupo de manutencao. Vale nas visoes: ordens."New value: +"Grupo de manutenção. Vale nas visões: ordens."

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

Previous value: -"Local de estoque / posto. Vale nas visoes: abastecimento."New value: +"Local de estoque / posto. Vale nas visões: abastecimento."

changedInput schema / properties / operador / description

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

changedInput schema / properties / placa / description

Previous value: -"Placa do veiculo. Vale nas visoes: cadastro, abastecimento."New value: +"Placa do veículo. Vale nas visões: cadastro, abastecimento."

changedInput schema / properties / plano / description

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

changedInput schema / properties / propriedade / description

Previous value: -"Se o equipamento e proprio ou de terceiro. Use para separar a frota da fazenda dos caminhoes de terceiros que so aparecem no carregamento. Vale nas visoes: cadastro."New value: +"Se o equipamento é próprio ou de terceiro. Use para separar a frota da fazenda dos caminhões de terceiros que só aparecem no carregamento. Vale nas visões: cadastro."

changedInput schema / properties / setor / description

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

changedInput schema / properties / status / description

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

changedInput schema / properties / subtipo / description

Previous value: -"Subtipo do cadastro. \"Frota\" e a frota de maquinas; terceirizados costumam vir com outro subtipo. Vale nas visoes: cadastro."New value: +"Subtipo do cadastro. \"Frota\" é a frota de máquinas; terceirizados costumam vir com outro subtipo. Vale nas visões: cadastro."

changedInput schema / properties / tipo / description

Previous value: -"Tipo da ordem. Casa por trecho: \"Preventiva\" acha \"Manutencao Preventiva\". Vale nas visoes: ordens."New value: +"Tipo da ordem. Casa por trecho: \"Preventiva\" acha \"Manutencao Preventiva\". Vale nas visões: ordens."

changedInput schema / properties / tipo_equipamento / description

Previous value: -"Tipo do equipamento. Vale nas visoes: cadastro."New value: +"Tipo do equipamento. Vale nas visões: cadastro."

changedInput schema / properties / visao / description

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

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

Behavior5/5

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

Annotations already carry readOnlyHint/openWorldHint, yet the description adds substantial non-obvious behavior: the default view, substring/accent-insensitive matching vs '(valor exato)' filters, the 'total_disponivel' response field, one-call pagination advice, and the critical data-quality warning that DATA_FINALIZACAO is only trustworthy when status is Finalizado.

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 summary followed by a scannable per-view bullet list, then global filter semantics and the calling rule. Length is justified by the 23-parameter surface, with only minor overlap between the bullet lists and the schema's own view annotations.

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 six-mode, 23-parameter query tool with an output schema, the description covers mode selection, defaults, filter semantics, response metadata, and pagination expectations. Nothing essential for a correct first call is missing, and the maintenance-order date caveat prevents a plausible misuse.

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 3-baseline applies, but the description adds cross-cutting meaning the schema lacks: global matching semantics ('casa por trecho, sem diferenciar maiúsculas nem acento') and the exception marking for exact-value filters. It also consolidates which filters belong to each view, though much of that duplicates the schema's per-parameter 'Vale nas visões' notes.

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 verb+resource and enumerates the covered subdomains (cadastro, abastecimento, ordens de manutenção, planos, custos), then explicitly separates itself from the sibling consultar_ordens_servico ('Ordem de manutenção é coisa distinta de ordem de serviço agrícola'). An agent can route 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 Guidelines4/5

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

Documents the 'visao' routing with per-view filters, states the default when visao is omitted, and gives calling guidance ('Chame uma vez só, já com o limite que a resposta vai usar — nunca repita a consulta mudando só o limite'). It flags the maintenance-vs-service-order distinction but does not name when to prefer consultar_ordens_servico or consultar_custos by tool name.

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?