> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Conecta agentes de IA con el servidor MCP de querying.ai > Da a Claude Code, Codex o cualquier cliente MCP herramientas para consultar motores de IA, extraer páginas, investigar prompts y gestionar monitores GEO. El servidor MCP de querying.ai expone la API como herramientas de [Model Context Protocol](https://modelcontextprotocol.io/). 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. | | | | - | - | | Endpoint | `https://mcp.querying.ai/mcp` | | Transporte | Streamable HTTP | | Autenticación | `Authorization: Bearer ` | ## Conecta un cliente Primero guarda tu clave en la variable de entorno `QUERYING_API_KEY`. Consigue una en [Claves de API](https://querying.ai/dashboard/keys). **Claude Code** ```bash theme={"theme":"css-variables"} claude mcp add --transport http querying \ https://mcp.querying.ai/mcp \ --header 'Authorization: Bearer ${QUERYING_API_KEY}' ``` 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. **Codex** Añade a `~/.codex/config.toml`: ```toml theme={"theme":"css-variables"} [mcp_servers.querying] url = "https://mcp.querying.ai/mcp" bearer_token_env_var = "QUERYING_API_KEY" tool_timeout_sec = 240 ``` **mcp.json** Para clientes que leen un archivo `mcp.json`: ```json theme={"theme":"css-variables"} { "mcpServers": { "querying": { "url": "https://mcp.querying.ai/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` Cualquier otro cliente Streamable HTTP funciona si envía estos encabezados en cada solicitud: ```http theme={"theme":"css-variables"} Authorization: Bearer Accept: application/json, text/event-stream Content-Type: application/json ``` 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 | Herramienta | Qué hace | Créditos | | - | - | - | | `run_prompt` | Envía un prompt a un motor y espera el resultado. | El precio del motor | | `submit_prompt` | Envía un prompt y devuelve al instante la tarea en cola. | El precio del motor | | `get_task` | Devuelve el estado de una tarea y su resultado cuando termina. | Gratis | | `scrape_page` | Lee una página web o un PDF de texto como Markdown (`WEB_SCRAPE`) y espera el resultado. | 1 por URL | | `read_product` | Lee una página de producto de una tienda (`COMMERCE_PRODUCT`) y espera su precio, stock, imágenes, imágenes de la descripción, especificaciones y opciones. | 3 por página | | `research_prompts` | Encuentra las preguntas que la gente hace a los asistentes de IA sobre un tema, ordenadas por demanda de búsqueda, con un `monitorSet` listo para `create_monitor`. Mercados US y KR. | 11 | | `run_product_lookup` | Pregunta a los motores de compras con IA por un producto y hasta 5 competidores y espera el resultado: si cada motor los muestra, vendedores, precios, sitios citados y cuáles aparecen en los prompts de compra. Mercados US y KR. | 10 por producto, 5 por prompt de compra | | `get_product_lookup` | Devuelve una consulta de Product Lookup por id, en resumen o completa. | Gratis | `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](/es/engines/overview.md) para los motores y sus precios, y [Prompt Research](/es/research/prompt-research.md) 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](/es/engines/commerce-serp.md). `read_product` recibe `url` y, opcionalmente, `country` e `idempotencyKey`; consulta [Commerce Product](/es/engines/commerce-product.md). `run_product_lookup` recibe `product`, `country` y, opcionalmente, `competitors`, `prompts`, `engines` e `idempotencyKey`; consulta [Product Lookup](/es/research/product-lookup.md). 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](/es/monitors.md). | Herramienta | Qué hace | Créditos | | - | - | - | | `get_monitor_capabilities` | Motores de monitores, créditos por tarea, límites y definiciones de métricas. Llámala antes de configurar un monitor. | Gratis | | `list_monitors` | Tus monitores con agregados de 30 días. | Gratis | | `get_monitor` | La vista de detalle heredada de un monitor. | Gratis | | `create_monitor` | Crea un monitor e inicia su primera ejecución. Cada ejecución envía una tarea por prompt, punto y muestra en cada motor. | Por ejecución; consulta [Coste y calendario](/es/monitors.md#coste-y-calendario) | | `update_monitor` | Cambia campos, o pausa y reanuda con `enabled`. | Gratis; más prompts o motores encarecen cada ejecución | | `delete_monitor` | Elimina un monitor y su historial de puntuaciones. No se puede deshacer. | Gratis | | `run_monitor` | Inicia una ejecución ahora. | Las tareas de una ejecución, cobradas como una ejecución programada | | `get_monitor_analytics` | Tasas de mención y de cita, comparación de periodos, cuota de voz, filas por motor y por prompt. | Gratis | | `get_monitor_sources` | Dominios o páginas citados, paginados con `nextCursor`. | Gratis | | `get_monitor_results` | Filas puntuadas, con texto de la respuesta y fuentes cuando `includeEvidence` es true. | Gratis | | `get_monitor_answer` | El Markdown, las fuentes y el contexto de puntuación de una respuesta. | Gratis | | `suggest_monitor_prompts` | Propone ideas de prompts a partir de datos de la marca. No se guarda nada. | Gratis; 30 llamadas por hora, una cada 20 segundos | | `get_monitor_alerts` | Historial de alertas y si la alerta está armada. | Gratis | | `test_monitor_alert` | Envía un correo de alerta de prueba. Limitado a 3 por monitor cada 5 minutos (`429 RATE_LIMITED`). | Gratis | ## 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: | Código | Significado | | - | - | | Códigos de error de la API como `KEY_SCOPE_DENIED` | La API rechazó la llamada; se incluyen el estado y los detalles. Consulta [Errores](/es/concepts/errors.md). | | `VALIDATION_ERROR` | La entrada de la herramienta no era válida. | | `TASK_TIMEOUT` | La espera terminó antes que la tarea. Incluye `taskId`. | | `LOOKUP_TIMEOUT` | La espera terminó antes que todas las consultas de Product Lookup. Incluye `lookupId` y los motores pendientes. | | `TASK_FAILED` | La tarea falló. Incluye `taskId` y el resultado de la tarea. | ## 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](/es/authentication.md#configuración-de-la-clave) en la clave limita lo que puede gastar el agente. Da a cada agente su propia clave con alcance y límite diario. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.