Chart Library

Chart Library MCP

Memória de mercado para IA, com pesquisa publicada para agentes e pessoas.

A versão 6.3.3 marca chamadas públicas de ferramentas com falha como erros MCP, preservando seus detalhes estruturados de recuperação. Solicitações inválidas explicam como corrigir as entradas; versões de publicação desatualizadas mantêm instruções para reiniciar a partir da visão geral atual. Esquemas de resposta bem-sucedidos e chamadas Python diretas permanecem compatíveis.

Cinco ferramentas somente leitura

Ferramenta	Entrada	Resultado
market_state	Símbolo; data opcional	Estado da sessão concluída, análogos históricos, faixas de resultados, memória de transição e fita
daily_note	Data opcional	Pesquisa diária publicada, regra de seleção e total de notas liquidadas
research_quality	Nenhuma	Recibo de calibração publicado, amostra datada e qualificações
search_research	Consulta; tipo, limite e deslocamento opcionais	Publicações relevantes, IDs, descobertas, recibos de amostra, limitações e versões
read_research	ID de pesquisa; seção, deslocamento e versão opcionais	Visão geral ou um documento de origem exato, com paginação e hashes

Solicitações de estado de mercado não precisam de pesquisa preliminar ou identificador de coorte. Para pesquisa publicada, pesquise um ID e depois leia suas evidências.

Exemplo de pergunta: "Leia o estado da sessão concluída mais recente da AAPL. Relate as faixas de análogos históricos, tamanhos de amostra, data da sessão e limitações."

Omitir a data usa a sessão mais recente construída/publicada, não uma cotação em tempo real. As datas usam AAAA-MM-DD. Evidências ausentes ou escassas permanecem ausentes ou escassas.

Conectar

O endpoint remoto principal é https://chartlibrary.io/mcp, usando HTTP Streamable e sem autenticação.

Para um cliente baseado em comandos, instale ou atualize o pacote:

python -m pip install --upgrade chartlibrary-mcp

Em seguida, use o equivalente desta configuração no seu cliente MCP:

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

Nenhuma chave de API ou pacotes Python no lado do servidor são necessários. Um CHART_LIBRARY_API_KEY opcional é encaminhado como token Bearer quando definido. Uma chave vazia não envia cabeçalho Authorization. CHART_LIBRARY_API_URL pode selecionar seu próprio endpoint compatível; aponte-o apenas para um servidor em que você confie com essa chave.

Python 3.10+ é necessário. Esta versão usa a interface FastMCP do MCP 1.x e fixa mcp>=1.28.1,<2.0.0; MCP 2.x é uma migração separada.

As chamadas 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 apenas a chamada relevante para a pergunta. Para um estado histórico, adicione &date=YYYY-MM-DD. Solicitações REST diárias chamam o parâmetro de data session.

Fluxo de trabalho de pesquisa

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

Substitua FULL_VERSION_FROM_SEARCH pela versão completa de 64 caracteres do resultado de pesquisa escolhido. Servidores atualizados fornecem documents[section].read_arguments diretamente; copie-os na ferramenta e siga content.next_read até null. Com servidores anteriores, passe a versão retornada e next_offset explicitamente. Omitir a versão opcional lê a publicação atual sem verificá-la em relação a respostas anteriores. Uma versão alterada retorna um erro explicando como reiniciar a partir da visão geral atual; o cliente não tenta novamente automaticamente.

Resumos de pesquisa são metadados de descoberta, não uma leitura de fonte. Leia guias disponíveis e descobertas limitantes relevantes antes de fazer afirmações. A pesquisa por palavras-chave classifica a relevância do documento, não a similaridade de mercado ou a força das evidências. Um resultado parcial significa que uma fonte de publicação não estava disponível. Artigos retirados não podem ser lidos. Datas de publicação e cortes de mercado diferem; o caso IONQ ao meio-dia não deve ser mesclado com análogos de estado de sessão concluída.

Exemplo completo de IONQ · Plano de pesquisa para agentes

Leia as evidências com precisão

• Preserve datas, tamanhos de amostra, recibos informativos, avisos e proveniência.
• Retornos excedentes de pacotes de estado são observações de pontos percentuais relativas a uma linha de base de ações líquidas com data correspondente. Cada horizonte tem seu próprio n observado.
• Percentis históricos brutos não são previsões calibradas automaticamente.
• research_quality audita apenas o método e a população que seu recibo nomeia. Não transfira sua porcentagem de cobertura para todos os estados de mercado ou toda a pesquisa.
• A pesquisa diária tem sua própria regra de seleção e total de notas liquidadas.
• Frequências históricas não são recomendações de compra ou venda.

O acesso à pesquisa é gratuito. Limites de serviço e termos de dados subjacentes ainda se aplicam. Respeite HTTP 429 e as orientações de nova tentativa; não assuma throughput ilimitado.

Integrações existentes

Nomes de ferramentas existentes permanecem registrados e chamáveis, incluindo pull_comps, search, state_packet e as ferramentas de inspeção de coorte. Para descobrir o menu estendido em um cliente local, defina CHART_LIBRARY_MCP_PROFILE=advanced. Isso altera a descoberta, não a autorização ou o acesso a pesquisa privada.

O menu público não expõe operações de fundos privados ou todos os métodos experimentais de memória de estado. Exemplos legados em examples/ usam a interface avançada.

Construa conosco

Para uma integração personalizada, um estudo maior ou um produto construído sobre a memória, entre em contato com Graham McCain — graham@chartlibrary.io.

Guia do desenvolvedor · Metodologia · Termos de dados · Privacidade

Verificação local

python -m pytest test_vendor_import.py

O teste de importação é executado sem chave de API e sem pacotes de aplicação services/ ou db/. Nenhuma publicação de pacote ou registro é realizada pelos testes.