As ferramentas MCP
As ferramentas MCP
Conectado o servidor MCP, o cliente ganha quatro ferramentas. Só uma delas cobra.
| Ferramenta | O que faz | Cobra? |
|---|---|---|
autoconsulta_list_products | Lista as consultas disponíveis para a sua conta, com preço | Não |
autoconsulta_describe_product | Detalha uma consulta: o que exige e o que entrega | Não |
autoconsulta_run_product | Executa uma consulta | Sim |
autoconsulta_check_result | Lê o resultado de uma consulta já executada | Não |
autoconsulta_list_products
Lista o catálogo da sua conta. Aceita filtro por texto livre, por categoria e pelo tipo de documento que a consulta exige.
Devolve, para cada item, o identificador, o nome, o preço para a sua conta e o prazo_tipico —
uma faixa (imediato, até 1 minuto, alguns minutos, assíncrono), não um tempo exato.
Quando não há medição suficiente, o campo vem vazio.
A listagem já traz apenas o que a sua conta pode usar. Uma consulta que não aparece aqui não está disponível para você.
O padrão traz 50 itens de um catálogo maior — o retorno inclui total e has_more para o
modelo saber que há mais.
autoconsulta_describe_product
Detalha uma consulta: o que ela entrega, quais campos exige na entrada (em JSON Schema) e o preço para a sua conta.
É o passo que o modelo deve dar antes de pedir seus dados — é daqui que ele descobre o que
perguntar. entrada.required é a lista do que é obrigatório.
autoconsulta_run_product
Executa a consulta e cobra. É a única que gasta dinheiro, e ela é declarada assim no protocolo MCP, com instrução explícita de confirmar com você antes de chamar.
Recebe o identificador da consulta e os campos de entrada.
- Se a consulta é rápida, o resultado volta na hora.
- Se demora, volta um
consultation_ide a instrução de não repetir a chamada — o resultado se lê comautoconsulta_check_result.
Se o cliente MCP repetir esta chamada, isso pode gerar nova cobrança. Por isso a instrução de não
repetir vem dentro da própria resposta: quando você vê um consultation_id, o caminho é ler,
não reexecutar. Veja Como a cobrança funciona.
autoconsulta_check_result
Lê o resultado pelo consultation_id. Nunca cobra, em nenhuma situação.
É a ferramenta certa para acompanhar uma consulta que ainda está processando — pode ser chamada quantas vezes for preciso, com alguns segundos entre uma e outra.
Enquanto processa, devolve que ainda está processando; não há resultado parcial.