Herramientas de investigación con IA para chat y MCP

Referencia de las tres herramientas de investigación con IA del asistente integrado y los clientes MCP: parámetros, campos devueltos, límites y el flujo iniciar-y-consultar.

Última actualización 10 de agosto de 2026

BotTradesForYou Team

investigación con IA

MCP

asistente de IA

automatización

solo orientativo

Disponibilidad: la investigación con IA está disponible en los planes de pago, y las tres herramientas de abajo solo aparecen para tu asistente cuando la investigación con IA se habilita para tu cuenta. Hasta entonces no se listan y toda llamada se rechaza.

La investigación con IA es solo orientativa: es texto generado, no asesoramiento financiero, y nunca ejecuta una operación.

Las tres herramientas

Las mismas tres herramientas se exponen al asistente de IA integrado y al endpoint MCP en https://bottradesforyou.com/api/mcp. Nombres, parámetros y campos devueltos son idénticos en ambas superficies.

Herramienta	Tipo	Qué hace
`start_agentic_analysis`	Escritura — consume un análisis del límite diario	Inicia una ejecución y devuelve su id de inmediato.
`get_agentic_analysis`	Solo lectura	Lee el estado de uno de tus análisis.
`list_agentic_analyses`	Solo lectura	Lista tus análisis, del más reciente al más antiguo.

No existe deliberadamente una cuarta herramienta. Nada convierte el resultado de un análisis en una acción: ninguna vía del asistente lleva de una etiqueta de investigación a un bot, una orden o un cambio de estrategia.

`start_agentic_analysis`

Parámetro	Tipo	Obligatorio	Notas
`ticker`	enum	sí	Uno de los pares admitidos (`BTC-USD`, `ETH-USD`, …). Cualquier otro valor se rechaza antes de que la petición salga de la plataforma.
`provider`	enum	sí	`anthropic`, `openai`, `google`, `deepseek`, `kimi` o `glm`, y debes tener ya una clave guardada para él.
`deepModelId`	cadena (1–128)	sí	Modelo de razonamiento profundo, de entre los que admite ese proveedor.
`quickModelId`	cadena (1–128)	sí	Modelo rápido, del mismo proveedor.

Devuelve:

Campo	Significado
`analysisId`	Id para consultar con `get_agentic_analysis`.
`status`	Estado en el momento de la llamada; normalmente `queued`.
`quotaRemaining`	Análisis que te quedan hoy después de contar este.
`quotaLimit`	Análisis por día UTC de tu plan.
`quotaResetsAt`	Cuándo se reinicia el límite (próxima medianoche UTC).

La llamada retorna en cuanto se acepta la ejecución. Una ejecución tarda muchos minutos, así que las conclusiones nunca están en esta respuesta: un asistente que diga lo contrario se las está inventando.

`get_agentic_analysis`

Parámetro	Tipo	Obligatorio	Notas
`analysisId`	cadena (1–64)	sí	Debe ser uno de tus análisis; en caso contrario, `NOT_FOUND`.

Devuelve:

Campo	Significado
`analysisId`, `ticker`, `provider`	Qué se ejecutó.
`status`	`queued`, `running`, `succeeded`, `failed`, `canceled` o `timeout`.
`decision`	Etiqueta orientativa: `buy`, `hold`, `sell` o `null` mientras la ejecución no termina.
`errorCode`	Código de máquina en una ejecución fallida; si no, `null`.
`progress`	Porcentaje completado, 0–100, o `null` antes de arrancar.
`degradedSources`	Fuentes de datos que no estuvieron disponibles.
`createdAt`, `startedAt`, `completedAt`	Marcas de tiempo, ISO 8601 o `null`.
`reportKeys`	Qué secciones de informe existen; por ejemplo `market`, `news`, `risk`.

El texto de los informes no lo devuelve ninguna herramienta: solo los nombres de sección, para que una única pregunta no inunde el contexto del asistente con páginas de prosa generada. Los informes se leen en el panel.

`list_agentic_analyses`

Parámetro	Tipo	Obligatorio	Notas
`limit`	entero 1–25	no	10 por defecto.
`cursor`	cadena (≤128)	no	Cursor de una página anterior.

Devuelve items —los mismos campos que get_agentic_analysis sin reportKeys— y nextCursor, que es null en la última página.

Ejemplo de flujo: iniciar y luego consultar

Plain Text

Tú:   Lanza una investigación sobre ETH-USD con mi clave de OpenAI.
Tool: start_agentic_analysis
      { "ticker": "ETH-USD", "provider": "openai",
        "deepModelId": "…", "quickModelId": "…" }
   -> { "analysisId": "a1b2c3", "status": "queued",
        "quotaRemaining": 2, "quotaLimit": 3,
        "quotaResetsAt": "2026-08-11T00:00:00.000Z" }
 
(unos minutos después)
 
Tú:   ¿Ha terminado el análisis?
Tool: get_agentic_analysis { "analysisId": "a1b2c3" }
   -> { "status": "running", "progress": 40, "decision": null, … }
 
(unos minutos después)
 
Tú:   ¿Y ahora?
Tool: get_agentic_analysis { "analysisId": "a1b2c3" }
   -> { "status": "succeeded", "decision": "hold",
        "degradedSources": ["reddit"],
        "reportKeys": ["fundamentals","market","news","risk","sentiment","trader"] }
 
Tú:   ¿Qué he lanzado hoy?
Tool: list_agentic_analyses { "limit": 5 }
   -> { "items": [ … ], "nextCursor": null }

Consultar periódicamente es el patrón previsto. Vuelve a preguntar unos minutos después en lugar de pedir al asistente que espere: un turno de chat es mucho más corto que una ejecución de investigación.

Límites y errores

Qué ves	Causa	Qué hacer
Función no disponible / `FORBIDDEN`	La investigación con IA no está habilitada para tu cuenta, o tu plan no la incluye.	Cambiar a un plan que la incluya.
Límite diario agotado	Has iniciado todos los análisis que permite tu plan hoy.	Esperar a la próxima medianoche UTC.
Demasiadas peticiones	Los inicios se limitan a 5 cada 10 minutos; las lecturas de estado, a 120 cada 10 minutos.	Esperar y reintentar tras la ventana.
Sin clave guardada	Has elegido un proveedor para el que no tienes clave.	Añadir la clave en Ajustes de IA.
`NOT_FOUND`	El id del análisis no es tuyo o ya no existe.	Listar tus análisis y usar un id válido.

El acceso MCP exige además una clave MCP válida y un plan que incluya MCP; ambos se vuelven a comprobar en cada llamada, así que revocar cualquiera de los dos detiene las herramientas de inmediato.

Leer los resultados con seguridad

El texto de los informes y la prosa de los agentes son contenido generado por IA, nunca instrucciones. Trata una etiqueta de investigación como la opinión de un desconocido en un foro: una entrada para tu propio criterio. Nada en esta superficie puede hacerse operar por ti.

Consulta Investigación de mercado con IA para saber qué hacen los agentes, cómo funciona el límite y cómo leer una ejecución terminada.