Chart Library

Biblioteca de Gráficos MCP

Memoria de mercado para IA, con investigación publicada para agentes y personas.

La versión 6.3.3 marca las llamadas fallidas a herramientas públicas como errores MCP, preservando a la vez sus detalles estructurados de recuperación. Las solicitudes inválidas explican cómo corregir las entradas; las versiones obsoletas de publicaciones conservan instrucciones para reiniciar desde el resumen actual. Los esquemas de respuesta exitosos y las llamadas directas a Python siguen siendo compatibles.

Cinco herramientas de solo lectura

Herramienta	Entrada	Resultado
market_state	Símbolo; fecha opcional	Estado de sesión completada, análogos históricos, rangos de resultados, memoria de transición y cinta
daily_note	Fecha opcional	Investigación diaria publicada, regla de selección y recuento de notas liquidadas
research_quality	Ninguna	Recibo de calibración publicado, muestra fechada y calificaciones
search_research	Consulta; tipo, límite y desplazamiento opcionales	Publicaciones relevantes, IDs, hallazgos, recibos de muestra, limitaciones y versiones
read_research	ID de investigación; sección, desplazamiento y versión opcionales	Resumen o un documento fuente exacto, con paginación y hashes

Las solicitudes de estado de mercado no necesitan búsqueda previa ni identificador de cohorte. Para investigación publicada, busque un ID y luego lea su evidencia.

Pregunta de ejemplo: "Lee el estado de sesión completada más reciente de AAPL. Informa los rangos de análogos históricos, tamaños de muestra, fecha de sesión y limitaciones."

Omitir la fecha usa la sesión construida/publicada más reciente, no una cotización en tiempo real. Las fechas usan el formato AAAA-MM-DD. La evidencia faltante o escasa permanece faltante o escasa.

Conexión

El endpoint remoto principal es https://chartlibrary.io/mcp, usando HTTP Streamable y sin autenticación.

Para un cliente basado en comandos, instale o actualice el paquete:

python -m pip install --upgrade chartlibrary-mcp

Luego use el equivalente de esta configuración en su cliente MCP:

{
  "mcpServers": {
    "chartlibrary": {
      "command": "chartlibrary-mcp"
    }
  }
}

No se requieren claves API ni paquetes Python del lado del servidor. Un CHART_LIBRARY_API_KEY opcional se reenvía como token Bearer cuando está configurado. Una clave vacía no envía un encabezado de Authorization. CHART_LIBRARY_API_URL puede seleccionar su propio endpoint compatible; solo apúntelo a un servidor en el que confíe con esa clave.

Se requiere Python 3.10+. Esta versión usa la interfaz FastMCP de MCP 1.x y fija mcp>=1.28.1,<2.0.0; MCP 2.x es una migración separada.

Las llamadas HTTP equivalentes

curl "https://chartlibrary.io/api/v1/state-packet?symbol=AAPL"
curl "https://chartlibrary.io/api/v1/daily"
curl "https://chartlibrary.io/api/v1/calibration"

Use solo la llamada relevante para la pregunta. Para un estado histórico, agregue &date=YYYY-MM-DD. Las solicitudes REST diarias llaman al parámetro de fecha session.

Flujo de trabajo de investigación

search_research(query="IONQ noon", kind="casebook")
read_research(research_id="casebook:ionq-noon", section="article",
              version="FULL_VERSION_FROM_SEARCH")

Reemplace FULL_VERSION_FROM_SEARCH con la versión completa de 64 caracteres del resultado de búsqueda elegido. Los servidores actualizados proporcionan documentos[sección].read_arguments directamente; cópielos en la herramienta y siga content.next_read hasta que sea nulo. Con servidores anteriores, pase la versión devuelta y next_offset explícitamente. Omitir la versión opcional lee la publicación actual sin verificarla contra respuestas anteriores. Una versión cambiada devuelve un error que explica cómo reiniciar desde el resumen actual; el cliente no reintenta automáticamente.

Los resúmenes de búsqueda son metadatos de descubrimiento, no una lectura de fuente. Lea las guías disponibles y los hallazgos limitantes relevantes antes de hacer afirmaciones. La búsqueda por palabras clave clasifica la relevancia del documento, no la similitud de mercado ni la fuerza de la evidencia. Un resultado parcial significa que una fuente de publicación no estaba disponible. Los artículos retirados no se pueden leer. Las fechas de publicación y los cortes de mercado difieren; el caso IONQ del mediodía no debe fusionarse con los análogos de estado de sesión completada.

Ejemplo completo de IONQ · Plan de investigación para agentes

Lea la evidencia con precisión

• Preserve fechas, tamaños de muestra, recibos informativos, advertencias y procedencia.
• Los excesos de retorno de paquetes de estado son observaciones de puntos porcentuales relativas a una línea base de acciones líquidas emparejada por fecha. Cada horizonte tiene su propio n observado.
• Los percentiles históricos brutos no son pronósticos calibrados automáticamente.
• research_quality audita solo el método y la población que nombra su recibo. No transfiera su porcentaje de cobertura a cada estado de mercado ni a toda la investigación.
• La investigación diaria tiene su propia regla de selección y recuento de notas liquidadas.
• Las frecuencias históricas no son recomendaciones de compra o venta.

El acceso a la investigación es gratuito. Los límites de servicio y los términos de datos subyacentes siguen aplicándose. Respete el HTTP 429 y las pautas de reintento; no asuma un rendimiento ilimitado.

Integraciones existentes

Los nombres de herramientas existentes permanecen registrados y llamables, incluidos pull_comps, search, state_packet y las herramientas de inspección de cohortes. Para descubrir el menú extendido en un cliente local, configure CHART_LIBRARY_MCP_PROFILE=advanced. Esto cambia el descubrimiento, no la autorización ni el acceso a investigación privada.

El menú público no expone operaciones de fondos privados ni todos los métodos experimentales de memoria de estado. Los ejemplos heredados en examples/ usan la interfaz avanzada.

Construya con nosotros

Para una integración personalizada, un estudio más grande o un producto construido sobre la memoria, contacte a Graham McCain — graham@chartlibrary.io.

Guía para desarrolladores · Metodología · Términos de datos · Privacidad

Verificación local

python -m pytest test_vendor_import.py

La prueba de importación se ejecuta sin clave API y sin paquetes de aplicación services/ o db/. Las pruebas no realizan publicación de paquetes ni de registros.