Saltar al contenido principal
El servidor MCP de querying.ai expone la API como herramientas de Model Context Protocol. Usa los mismos motores, la misma cola, las mismas formas de resultado y las mismas claves de API que la API REST, y no almacena tu clave ni tus tareas.

​
Conecta un cliente

Primero guarda tu clave en la variable de entorno QUERYING_API_KEY. Consigue una en Claves de API.
Mantén las comillas simples. Con comillas dobles tu shell expande la clave una vez y Claude Code guarda el valor en su archivo de configuración.
Cualquier otro cliente Streamable HTTP funciona si envía estos encabezados en cada solicitud:
Una solicitud sin encabezado bearer devuelve 401. Una clave no válida se notifica en la primera llamada a una herramienta, como error de herramienta.

​
Herramientas

Las herramientas que envían tareas cuestan lo mismo que la llamada equivalente a la API. Las herramientas de solo lectura son gratuitas.

​
Tareas e investigación

run_prompt y submit_prompt reciben taskType, prompt y, opcionalmente, country, idempotencyKey, include y page (de 1 a 10, para GOOGLE_SERP y NAVER_SERP). Consulta Motores para los motores y sus precios, y Prompt Research para los parámetros de investigación. Para COMMERCE_SERP, envía site y query en lugar de prompt, con limit opcional (de 1 a 40); consulta Commerce Search. read_product recibe url y, opcionalmente, country e idempotencyKey; consulta Commerce Product. run_product_lookup recibe product, country y, opcionalmente, competitors, prompts, engines e idempotencyKey; consulta Product Lookup. Devuelve un resumen: por producto, los motores que lo muestran, su rango de precios, los 10 primeros vendedores y sitios citados y una fila por motor; por prompt de compra, los productos que cada motor mostró o nombró. Es una décima parte de la respuesta completa, aproximadamente. Pasa detail: "full" para obtener cada listado, página citada e id de tarea.

​
Monitores GEO

Cada herramienta de monitores hace una llamada a la API con tu clave, así que la propiedad, el alcance de la clave y los límites del plan se aplican igual que por REST. Consulta Monitorización GEO.

​
Tiempos de espera

run_prompt, scrape_page, read_product y research_prompts sondean hasta que la tarea termina. Esperan timeoutSeconds (180 por defecto, 900 como máximo). Si la tarea sigue en curso, la herramienta devuelve un error TASK_TIMEOUT con el taskId. La tarea sigue ejecutándose; llama a get_task con ese id para recogerla. run_product_lookup sondea la consulta de la misma forma. Espera 210 segundos por defecto para terminar dentro de un timeout de cliente de 240 segundos, y la mayoría de las consultas terminan en 2 a 3 minutos. Si la consulta sigue en curso, la herramienta devuelve un error LOOKUP_TIMEOUT con el lookupId; llama a get_product_lookup con ese id. Configura el tiempo de espera de herramientas de tu cliente por encima de timeoutSeconds. El ejemplo de Codex usa tool_timeout_sec = 240 para el valor por defecto de 180 segundos. Si tu cliente solo permite llamadas cortas, usa submit_prompt y después get_task.

​
Errores

Los errores de herramienta llegan como JSON en el resultado de la herramienta:

​
Facturación

Cada llamada a una herramienta se factura a la cuenta propietaria de la clave, a los mismos precios que la API REST. Se aplica la configuración de la clave: un alcance de motores o límite diario de créditos en la clave limita lo que puede gastar el agente. Da a cada agente su propia clave con alcance y límite diario.