Chart Library — Market-state research

Chart Library MCP

AI と人々のための市場の記憶。エージェント向けに公開された調査を提供します。

バージョン 6.3.3 では、公開ツールの呼び出し失敗を MCP エラーとして示しつつ、構造化された復旧情報を保持します。無効なリクエストには入力の修正方法が示され、古い公開バージョンでは、最新の概要からやり直す手順が保持されます。成功時のレスポンススキーマと Python の直接呼び出しには互換性があります。

読み取り専用ツール 5 種類

ツール	入力	結果
market_state	シンボル。日付は任意	完了したセッションの状態、過去の類似事例、結果の範囲、推移の記憶、テープ
daily_note	日付は任意	公開された日次調査、選択ルール、確定済みノートの集計
research_quality	なし	公開されたキャリブレーションレシート、日付付きサンプル、注意事項
search_research	クエリ。種類、件数上限、オフセットは任意	関連する公開資料、ID、調査結果、サンプルレシート、制限事項、バージョン
read_research	調査 ID。セクション、オフセット、バージョンは任意	概要または正確なソース文書。ページネーションとハッシュを含みます

市場状態のリクエストには、事前の検索やコホートハンドルは必要ありません。公開された調査については、まず ID を検索し、その後、根拠資料を読み取ります。

質問の例：「AAPL の直近の完了セッションの状態を読み取ってください。過去の類似事例の範囲、サンプル数、セッションの日付、制限事項を報告してください。」

日付を省略すると、リアルタイムの株価ではなく、最新の構築済み／公開済みセッションが使われます。日付は YYYY-MM-DD 形式です。根拠がない場合や乏しい場合は、その状態が維持されます。

接続

主なリモートエンドポイントは https://chartlibrary.io/mcp です。Streamable HTTP を使用し、認証は不要です。

コマンドベースのクライアントでは、パッケージをインストールまたはアップグレードします。

python -m pip install --upgrade chartlibrary-mcp

次に、MCP クライアントで以下と同等の設定を使用します。

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

API キーやサーバー側の Python パッケージは不要です。任意の CHART_LIBRARY_API_KEY を設定すると、Bearer トークンとして転送されます。キーが空の場合、Authorization ヘッダーは送信されません。CHART_LIBRARY_API_URL を使って、互換性のある独自のエンドポイントを選択できます。このキーを預けてもよいと信頼できるサーバーのみを指定してください。

Python 3.10 以降が必要です。このリリースでは MCP 1.x の FastMCP インターフェイスを使用し、mcp>=1.28.1,<2.0.0 に固定しています。MCP 2.x への移行は別途必要です。

同等の HTTP 呼び出し

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

質問に関係する呼び出しのみを使用してください。過去の状態を取得する場合は、&date=YYYY-MM-DD を追加します。日次 REST リクエストでは、日付パラメーターに session という名前を使います。

調査ワークフロー

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

FULL_VERSION_FROM_SEARCH を、選択した検索結果にある 64 文字の完全なバージョンに置き換えます。更新済みのサーバーでは documents[section].read_arguments が直接提供されるので、それらをツールにコピーし、content.next_read が null になるまで読み進めます。以前のサーバーでは、返されたバージョンと next_offset を明示的に渡します。任意のバージョンを省略すると、以前のレスポンスとの照合は行わず、現在の公開資料を読み取ります。バージョンが変更されている場合は、最新の概要からやり直す方法を説明するエラーが返されます。クライアントによる自動再試行は行われません。

検索サマリーは発見用のメタデータであり、ソースの読み取りではありません。主張を行う前に、利用可能なガイドと、関連する制限事項を示す調査結果を読んでください。キーワード検索が順位付けするのは文書の関連性であり、市場の類似性や根拠の強さではありません。部分的な結果は、公開資料のソースが利用できなかったことを意味します。 取り下げられた記事は読み取れません。公開日と市場のカットオフは異なるため、正午時点の IONQ の事例を、完了セッションの状態に基づく類似事例と統合してはいけません。

IONQ の完全な例 · エージェント向け調査計画

エビデンスを正確に読み取る

• 日付、サンプル数、参考となる受領記録、警告、出典情報を保持してください。
• ステートパケットの超過リターンは、日付を一致させた流動性の高い株式のベースラインと比較したパーセンテージポイント単位の観測値です。各期間の観測数 n はそれぞれ異なります。
• 過去の生パーセンタイルは、自動的に較正済みの予測になるわけではありません。
• research_quality が監査するのは、受領記録に記載された手法と母集団のみです。そのカバー率をすべての市場状態やすべての調査に当てはめないでください。
• 日次調査には、独自の選定ルールと確定済みノートの集計があります。
• 過去の頻度は、売買の推奨ではありません。

調査へのアクセスは無料です。サービスの制限と基盤となるデータの利用条件は引き続き適用されます。 HTTP 429 と再試行の案内に従ってください。無制限に利用できると想定しないでください。

既存のインテグレーション

pull_comps、search、state_packet、コホート検査ツールなど、既存のツール名は登録されたまま呼び出し可能です。ローカルクライアントで拡張メニューを見つけるには、CHART_LIBRARY_MCP_PROFILE=advanced を設定してください。 これは検出方法を変更するものであり、非公開の調査に対する認可やアクセスを変更するものではありません。

公開メニューには、非公開のファンド運用や、実験的なステートメモリー手法のすべては含まれていません。examples/ の従来の例では、拡張インターフェースを使用します。

一緒に構築しましょう

カスタムインテグレーション、より大規模な調査、またはメモリーを基盤とする製品については、Graham McCain — [email protected] までお問い合わせください。

開発者ガイド · 手法 · データ利用条件 · プライバシー

ローカルでの検証

python -m pytest test_vendor_import.py

インポートのスモークテストは、API キーやアプリケーションの services/ または db/ パッケージなしで実行されます。テストによるパッケージまたはレジストリへの公開は行われません。