Conecte agentes de IA com o servidor MCP da querying.ai

O servidor MCP da querying.ai expõe a API como ferramentas do Model Context Protocol. Ele usa os mesmos mecanismos, a mesma fila, os mesmos formatos de resultado e as mesmas chaves de API da API REST, e não armazena sua chave nem suas tarefas.


Endpoint	`https://mcp.querying.ai/mcp`
Transporte	Streamable HTTP
Autenticação	`Authorization: Bearer <API key>`

Conecte um cliente

Primeiro, coloque sua chave na variável de ambiente QUERYING_API_KEY. Obtenha uma em Chaves de API.

Claude Code
Codex
mcp.json

claude mcp add --transport http querying \
  https://mcp.querying.ai/mcp \
  --header 'Authorization: Bearer ${QUERYING_API_KEY}'

Mantenha as aspas simples. Com aspas duplas, seu shell expande a chave uma vez e o Claude Code grava o valor no arquivo de configuração dele.

Adicione a ~/.codex/config.toml:

[mcp_servers.querying]
url = "https://mcp.querying.ai/mcp"
bearer_token_env_var = "QUERYING_API_KEY"
tool_timeout_sec = 240

Para clientes que leem um arquivo mcp.json:

{
  "mcpServers": {
    "querying": {
      "url": "https://mcp.querying.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Qualquer outro cliente Streamable HTTP funciona se enviar estes cabeçalhos em cada requisição:

Authorization: Bearer <API key>
Accept: application/json, text/event-stream
Content-Type: application/json

Uma requisição sem cabeçalho bearer retorna 401. Uma chave inválida é informada na primeira chamada de ferramenta, como erro da ferramenta.

Ferramentas

As ferramentas que enviam tarefas custam o mesmo que a chamada equivalente à API. As ferramentas somente leitura são gratuitas.

Tarefas e pesquisa

Ferramenta	O que faz	Créditos
`run_prompt`	Envia um prompt a um mecanismo e espera o resultado.	O preço do mecanismo
`submit_prompt`	Envia um prompt e devolve na hora a tarefa na fila.	O preço do mecanismo
`get_task`	Devolve o status de uma tarefa e, quando ela termina, o resultado.	Grátis
`scrape_page`	Lê uma página web ou um PDF de texto como Markdown (`WEB_SCRAPE`) e espera o resultado.	1 por URL
`read_product`	Lê uma página de produto de uma loja (`COMMERCE_PRODUCT`) e espera preço, estoque, imagens, imagens da descrição, especificações e opções.	3 por página
`research_prompts`	Encontra as perguntas que as pessoas fazem a assistentes de IA sobre um tema, ordenadas por demanda de busca, com um `monitorSet` pronto para `create_monitor`. Mercados US e KR.	11
`run_product_lookup`	Pergunta aos mecanismos de compras com IA sobre um produto e até 5 concorrentes e espera o resultado: se cada mecanismo os mostra, vendedores, preços, sites citados e quais surgem nos prompts de compra. Mercados US e KR.	10 por produto, 5 por prompt de compra
`get_product_lookup`	Devolve uma consulta de Product Lookup por id, em resumo ou completa.	Grátis

run_prompt e submit_prompt recebem taskType, prompt e, opcionalmente, country, idempotencyKey, include e page (1 a 10, para GOOGLE_SERP e NAVER_SERP). Veja Mecanismos para os mecanismos e seus preços, e Prompt Research para as entradas da pesquisa. Para COMMERCE_SERP, envie site e query no lugar de prompt, com limit opcional (1 a 40); veja Commerce Search. read_product recebe url e, opcionalmente, country e idempotencyKey; veja Commerce Product. run_product_lookup recebe product, country e, opcionalmente, competitors, prompts, engines e idempotencyKey; veja Product Lookup. Ela devolve um resumo: por produto, os mecanismos que o mostram, a faixa de preço, os 10 principais vendedores e sites citados e uma linha por mecanismo; por prompt de compra, os produtos que cada mecanismo mostrou ou citou pelo nome. Isso é cerca de um décimo da resposta completa. Passe detail: "full" para obter cada listagem, página citada e id de tarefa.

Monitores GEO

Cada ferramenta de monitor faz uma chamada à API com a sua chave, então propriedade, escopo da chave e limites do plano valem como no REST. Veja Monitoramento GEO.

Ferramenta	O que faz	Créditos
`get_monitor_capabilities`	Mecanismos de monitor, créditos por tarefa, limites e definições das métricas. Chame antes de configurar um monitor.	Grátis
`list_monitors`	Seus monitores, com consolidados de 30 dias.	Grátis
`get_monitor`	A visão de detalhe legada de um monitor.	Grátis
`create_monitor`	Cria um monitor e inicia a primeira execução. Cada execução envia uma tarefa por prompt, ponto e amostra em cada mecanismo.	Por execução; veja Custo e agenda
`update_monitor`	Altera campos, ou pausa e retoma com `enabled`.	Grátis; mais prompts ou mecanismos aumentam o custo de cada execução
`delete_monitor`	Exclui um monitor e seu histórico de pontuação. Não pode ser desfeito.	Grátis
`run_monitor`	Inicia uma execução agora.	As tarefas de uma execução, cobradas como uma execução agendada
`get_monitor_analytics`	Taxas de menção e citação, comparação entre períodos, share of voice, linhas por mecanismo e por prompt.	Grátis
`get_monitor_sources`	Domínios ou páginas citados, paginados com `nextCursor`.	Grátis
`get_monitor_results`	Linhas pontuadas, com texto da resposta e fontes quando `includeEvidence` é true.	Grátis
`get_monitor_answer`	O Markdown, as fontes e o contexto de pontuação de uma resposta.	Grátis
`suggest_monitor_prompts`	Rascunha ideias de prompts a partir de informações da marca. Nada é salvo.	Grátis; 30 chamadas por hora, uma a cada 20 segundos
`get_monitor_alerts`	Histórico de alertas e se o alerta está armado.	Grátis
`test_monitor_alert`	Envia um e-mail de alerta de teste. Limitado a 3 por monitor a cada 5 minutos (`429 RATE_LIMITED`).	Grátis

Timeouts

run_prompt, scrape_page, read_product e research_prompts fazem polling até a tarefa terminar. Elas esperam timeoutSeconds (padrão 180, máximo 900). Se a tarefa ainda estiver em execução, a ferramenta retorna um erro TASK_TIMEOUT com o taskId. A tarefa continua sendo executada; chame get_task com esse id para coletá-la. run_product_lookup faz polling da consulta da mesma forma. Ela espera 210 segundos por padrão para terminar dentro de um timeout de cliente de 240 segundos, e a maioria das consultas termina em 2 a 3 minutos. Se a consulta ainda estiver em execução, a ferramenta devolve um erro LOOKUP_TIMEOUT com o lookupId; chame get_product_lookup com esse id. Configure o timeout de ferramentas do seu cliente acima de timeoutSeconds. O exemplo do Codex usa tool_timeout_sec = 240 para o padrão de 180 segundos. Se o seu cliente só permite chamadas de ferramenta curtas, use submit_prompt e depois get_task.

Erros

Os erros de ferramenta voltam como JSON no resultado da ferramenta:

Código	Significado
Códigos de erro da API, como `KEY_SCOPE_DENIED`	A API rejeitou a chamada; o status e os detalhes vêm incluídos. Veja Erros.
`VALIDATION_ERROR`	A entrada da ferramenta era inválida.
`TASK_TIMEOUT`	A espera terminou antes de a tarefa terminar. Inclui `taskId`.
`LOOKUP_TIMEOUT`	A espera terminou antes de todas as consultas do Product Lookup terminarem. Inclui `lookupId` e os mecanismos pendentes.
`TASK_FAILED`	A tarefa falhou. Inclui `taskId` e o resultado da tarefa.

Cobrança

Toda chamada de ferramenta é cobrada da conta dona da chave, pelos mesmos preços da API REST. As configurações da chave valem: um escopo de mecanismos ou limite diário de créditos na chave limita o que o agente pode gastar. Dê a cada agente uma chave própria, com escopo e limite diário.

Primeiros passos

Conceitos principais

Mecanismos de resposta

Busca e dados da web

Opções de requisição

Pesquisa

Monitoramento GEO

Conta e dados

Conecte agentes de IA com o servidor MCP da querying.ai

Conecte um cliente

Ferramentas

Tarefas e pesquisa

Monitores GEO

Timeouts

Erros

Cobrança

​Conecte um cliente

​Ferramentas

​Tarefas e pesquisa

​Monitores GEO

​Timeouts

​Erros

​Cobrança

Conecte um cliente

Ferramentas

Tarefas e pesquisa

Monitores GEO

Timeouts

Erros

Cobrança