QuantGist

QuantGist MCP Server

QuantGist のマクロ経済イベントデータを Model Context Protocol (MCP) ツールとして提供します。Claude などの AI エージェントが、会話の中でカレンダーを照会したり、イベントが近づいているか確認したり、取引の安全性を評価したりできます。

機能

このサーバーは、MCP 対応クライアント（Claude Desktop、Claude Code、カスタムエージェント）が呼び出せる 22 個のツールを登録します。

マクロ経済イベント

ツール	説明
get_upcoming_events	今後 N 時間以内に予定されているイベントを、影響度で絞り込んで取得します
get_events_range	国／シンボル／影響度による任意の絞り込みに対応した、指定期間内のイベントを取得します
get_economic_calendar	/calendar から1日分のマクロ経済カレンダー全体を、時刻別に分類し、カバレッジ／警告のメタデータとともに取得します
get_event_detail	ID を指定して、1件のイベントの詳細（実績、予測、前回値、シンボル）を取得します

決算

ツール	説明
get_earnings_upcoming	EPS／売上高の予測値を含む、全ティッカーの今後の決算報告を取得します
get_earnings_for_ticker	1つのティッカーの決算履歴（予測値と実績値、予想超過／未達、EDGAR リンク）を取得します
get_earnings_summary	1つのティッカーの予想超過／未達／予想どおりの件数と、全体の予想超過率を取得します
get_earnings_surprises	最新の決算報告の中から、市場全体で EPS の予想を最も大きく上回った銘柄を取得します
get_earnings_season_summary	現在の決算シーズンのインデックスレベルの概要を取得します

市場

ツール	説明
get_markets_overview	主要な指数や金融商品（S&P 500、Nasdaq、金、原油など）の日次終値を取得します

検出とヘルプ（読み取り専用、API キー不要）

ツール	説明
get_pricing	プラン、価格、機能の利用条件（無料からエンタープライズまで）と Bot Usage Add-On を取得します
get_limits	プランごとの上限（リクエスト枠、履歴期間、データ遅延、WS、ウォッチリスト、レート制限）を取得します
recommend_endpoint	自然言語で記述されたユースケースに最適な REST エンドポイントと MCP ツールを対応付けます
get_status	API への接続状況を確認し、公開ステータスページへのリンクを取得します
estimate_usage_cost	リクエスト数に適したプランと、超過料金／Bot Usage Add-On に関する注意事項を見積もります

アカウント（Webhook、API キー、請求）

ツール	説明
get_subscription	現在のプラン、ステータス、請求期間を取得します（読み取り専用）
list_webhooks	登録済みの Webhook エンドポイントを一覧表示します（読み取り専用、Pro プラン）
create_webhook	HTTPS Webhook エンドポイントを登録します。実行には確認が必要で、署名シークレットは一度だけ表示されます
delete_webhook	Webhook エンドポイントを完全に削除します。実行には確認が必要で、取り消せません
test_webhook	署名付きの合成テスト配信を送信し、受信側を検証します
create_api_key	（任意のスコープを設定した）API キーを作成します。実行には確認が必要で、キーは一度だけ表示されます
create_checkout_session	プランのアップグレード用に Stripe Checkout セッションを作成します。実行には確認が必要で、課金は一切行われません

書き込みツールと同意モデル

変更を加えるツールは、明示的な human-in-the-loop パターンに従います。

• confirm: true が必須です。 これを指定せずに呼び出すと、変更を加えるツールはAPI を呼び出さず、実行される内容のプレビューをそのまま返します。これにより、エージェントは先にユーザーの承認を得られます。
• 請求に関する制約。 create_checkout_session は一切課金しません。人間がブラウザーで開いて手続きを完了する必要がある、Stripe がホストするチェックアウト URL を返します。カード情報がツールや QuantGist の API を通過することはありません。支払い後、プランは自動的にアップグレードされます。
• シークレットは一度のみ返されます。 新しい API キーと Webhook 署名シークレットは一度だけ返され、env var またはシークレットマネージャーに保存するよう警告されます。コミットするファイルには絶対に保存しないでください。
• サーバー側の強制適用が優先されます。 プランによる制限（Webhook には Pro が必要）とキーのスコープは QuantGist API 自体が強制します。ツールは制限を回避せず、403 エラーに対して実行可能なヒントを提示します。

要件

• Python 3.10 以降（ローカル／stdio でのインストールに必要です。ホスト型サーバーでは不要です）
• QuantGist API キー — quantgist.com で取得できます（無料枠：1 日 100 回）

ホスト型サーバーに接続する（インストール不要）

MCP サーバーは https://api.quantgist.com/mcp で HTTP 経由でホストされています。インストールも Python も不要です。ストリーム可能 HTTP トランスポートに対応したクライアントであれば、 X-API-Key ヘッダーに QuantGist キーを指定して接続できます（マルチテナント方式で、ご自身の利用枠に課金されます）。

Claude Code では、次の 1 つのコマンドで接続できます。

claude mcp add --transport http quantgist https://api.quantgist.com/mcp \
  --header "X-API-Key: qg_live_YOUR_KEY"

ストリーム可能 HTTP に対応した任意の MCP クライアント：

{
  "mcpServers": {
    "quantgist": {
      "type": "streamable-http",
      "url": "https://api.quantgist.com/mcp",
      "headers": { "X-API-Key": "qg_live_YOUR_KEY" }
    }
  }
}

URL のみを受け付けるコネクター（ChatGPT など）： カスタムヘッダーを設定できない場合は、代わりに URL に キーを含めてください — https://api.quantgist.com/mcp?apiKey=qg_live_YOUR_KEY（ Authorization: Bearer <key> も使用できます）。可能な場合はヘッダーを使うことをおすすめします。キーを URL に含めると、 プロキシ／サーバーのログに記録されることがあるためです。

自分で実行したい場合は、ローカルにインストールする（以下を参照）か、HTTP サーバーをセルフホストしてください。DEPLOY.md を参照してください。

インストール

オプション A — パッケージからインストール（推奨）

pip install quantgist-mcp
# or with uv:
uv pip install quantgist-mcp

オプション B — ソースからインストール（開発用）

git clone https://github.com/QuantGist-Technologies/QuantGist_MCP
cd QuantGist_MCP
uv sync          # installs all dependencies into a venv
uv run quantgist-mcp   # start the server

Claude Desktop の設定

Claude Desktop の設定ファイルを探します。

プラットフォーム	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

quantgist サーバーブロックを追加します（claude_desktop_config_example.json を参照）。

{
  "mcpServers": {
    "quantgist": {
      "command": "quantgist-mcp",
      "env": {
        "QUANTGIST_API_KEY": "qg_live_YOUR_KEY_HERE"
      }
    }
  }
}

保存後、Claude Desktop を再起動します。ツール一覧にツールが表示されます。

グローバルインストールの代わりに uv run を使用する

グローバルにインストールしない場合は、Claude Desktop で uv run を指定します。

{
  "mcpServers": {
    "quantgist": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/Quangist_MCP", "quantgist-mcp"],
      "env": {
        "QUANTGIST_API_KEY": "qg_live_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Code の設定

プロジェクト内の .claude/mcp_settings.json（またはグローバルの ~/.claude/mcp_settings.json）に追加します。

{
  "mcpServers": {
    "quantgist": {
      "command": "quantgist-mcp",
      "env": {
        "QUANTGIST_API_KEY": "qg_live_YOUR_KEY_HERE"
      }
    }
  }
}

セルフホスト（HTTP トランスポート）

上記の stdio トランスポートに加えて、サーバーは quantgist-mcp-http エントリーポイントを使って ホスト型 HTTP サービスとして実行できます（GET /health、MCP は /mcp）。リクエストごとの X-API-Key ヘッダー（マルチテナント方式）、またはサーバー側の QUANTGIST_API_KEY 環境変数を受け付けます。

docker build -t quantgist-mcp .
docker run -p 8000:8000 -e QUANTGIST_API_KEY=qg_live_YOUR_KEY quantgist-mcp
curl http://localhost:8000/health

Docker、Docker Compose、Coolify を使ったデプロイについては、DEPLOY.md を参照してください。

ツールリファレンス

get_upcoming_events

今後 N 時間以内のイベントを返します。

パラメーター	型	デフォルト	説明
hours	integer (1–168)	24	先読みする時間数
impact	high | medium | low | all	high	影響度フィルター

get_events_range

指定した日付範囲のイベントを返します。

パラメーター	型	必須	説明
from_date	ISO string	Yes	開始日／日時
to_date	ISO string	Yes	終了日／日時
country	string	No	2 文字の国コード（例："US"）
impact	enum	No	high | medium | low | all
symbol	string	No	取引シンボル（例："XAUUSD"）

get_economic_calendar

当日のマクロ経済カレンダーを、発表時刻ごとにまとめて返します。このツールは GET /v1/calendar?envelope=true を呼び出し、幅広い /events フィードは呼び出しません。そのため、一般的な 金融ニュースの見出しが、予定されているマクロ経済指標の発表に混在することはありません。

構造化出力では、バックエンドのエンベロープが保持されます。

• events / count / returned_count
• total_count
• coverage
• warnings
• truncated
• schema_version

バックエンドの応答が一部のみの場合、古い場合、MCP の安全上限によって切り詰められた場合、または 必須のカレンダーエンベロープがない場合、ツールはその内容を warnings で通知し、 /events へのフォールバックは行いません。

パラメーター	型	デフォルト	説明
date	ISO date	today (UTC)	取得する日付
impact	enum	high	影響度フィルター

get_event_detail

1 つのイベントの詳細情報をすべて返します。

パラメーター	型	必須	説明
event_id	string	はい	ほかの任意のツールから取得したイベント ID

get_earnings_upcoming

全ティッカーの次回以降の決算報告を、報告日順に返します。

パラメーター	型	デフォルト	説明
limit	integer (1–100)	20	返す今後の報告数

get_earnings_for_ticker

1 つのティッカーの決算履歴（EPS の予想と実績、売上高、予想超過・未達、EDGAR リンク）を返します。

パラメーター	型	デフォルト	説明
ticker	string	必須	株式ティッカー。例："AAPL"
limit	integer (1–50)	10	返す過去の報告数

get_earnings_summary

ティッカーの予想超過・未達・予想どおりの件数と、全体の予想超過率を返します。

パラメーター	型	必須	説明
ticker	string	はい	株式ティッカー。例："AAPL"

get_earnings_surprises

直近の報告における、市場全体で最大の EPS サプライズを返します。

パラメーター	型	デフォルト	説明
limit	integer (1–50)	20	上位サプライズの返却数

get_earnings_season_summary

現在の決算シーズンの指数レベルの概要（報告総数、全体の予想超過率、EPS サプライズの平均、シーズンラベル）を返します。パラメーターはありません。

get_markets_overview

主要な市場指数および金融商品（S&P 500、Nasdaq、Dow Jones、金、原油など）の終値を返します。パラメーターはありません。

get_subscription

認証済みアカウントのプラン、ステータス、請求期間を返します。パラメーターはありません。読み取り専用です。

list_webhooks

アカウントに登録されている webhook エンドポイントを一覧表示します。パラメーターはありません。読み取り専用です。webhook の利用には Pro プランが必要です。

create_webhook

HTTPS webhook エンドポイントを登録します（Pro プラン）。確認が必要です。confirm: true を指定しない場合はプレビューを返し、API 呼び出しは行いません。署名シークレットが返されるのは 1 回限りです。

パラメーター	型	デフォルト	説明
url	string (required)	—	イベントの POST を受信する HTTPS URL
events	string[]	["*"]	イベントタイプ：economic_release、earnings、earnings.scheduled、earnings.confirmed、earnings.reported、earnings.surprise、news.radar.breaking、または *
impact_filter	string[]	—	例：["high"]。指定したインパクトレベルのイベントのみを配信します
confirm	boolean	false	実際に作成するには true が必要です

delete_webhook

webhook エンドポイントとその配信履歴を完全に削除します。確認が必要な破壊的操作です。

パラメーター	型	デフォルト	説明
webhook_id	string (required)	—	list_webhooks で取得したエンドポイント ID
confirm	boolean	false	実際に削除するには true が必要です

test_webhook

署名付きの合成テストイベントを webhook エンドポイントに送信し、到達可能性と X-QuantGist-Signature の検証を確認します。

パラメーター	型	デフォルト	説明
webhook_id	string (required)	—	list_webhooks で取得したエンドポイント ID

create_api_key

必要に応じてスコープを指定し、新しい API キーを作成します。確認が必要です。キー全体が返されるのは 1 回限りです。安全な場所に保管してください。

パラメーター	型	デフォルト	説明
name	string	"Agent key"	人が読めるラベル
environment	live | test	live	本番データとサンドボックスのどちらを使用するか
scopes	string[]	["*"]	最小権限を推奨します：events:read、calendar:read、webhooks:manage、usage:read、watchlists:manage
confirm	boolean	false	実際に作成するには true が必要です

create_checkout_session

プランのアップグレード用にStripe Checkoutセッションを作成します。課金は一切行いません — 人間が開いて完了する必要がある、StripeがホストするチェックアウトURLを返します。確認が必要です。

パラメーター	型	デフォルト	説明
plan	starter | pro | team（必須）	—	変更先のプラン
confirm	boolean	false	trueである必要があり、ユーザーがアップグレードを明示的に承認した後にのみ指定できます

プロンプトの例

サーバーに接続すれば、次のプロンプトをそのまま利用できます。

• 「今後4時間で影響の大きいイベントは何ですか？」
• 「今日の経済カレンダーをすべて表示してください」
• 「今週の影響の大きいUSDイベントを表示してください」
• 「今週金曜日にEURUSDに影響するマクロイベントは何ですか？」
• 「イベントID abc123の詳細を取得してください」
• 「まもなく決算を発表する企業はどこですか？」
• 「AAPLの決算予想超過率を表示してください」
• 「今シーズンで最も大きかったEPSのサプライズは何ですか？」
• 「市場の概要を手短に教えてください」
• 「現在のプランを教えてください」
• 「影響の大きいUSDイベント用に、https://my-bot.example.com/hooks へのWebhookを設定してください」
• 「バックテスター用の読み取り専用テストAPIキーを作成してください」
• 「Proにアップグレードしたいです」 (エージェントがStripeのチェックアウトリンクを渡します — 支払いは常にユーザー自身が行います)

環境変数

変数	必須	説明
QUANTGIST_API_KEY	はい	QuantGist APIキー（qg_live_... または qg_test_...）

開発

uv sync
uv run quantgist-mcp          # run the MCP server
uv run pytest                 # run tests (if present)
uv run ruff check src/        # lint
uv run ruff format src/       # format

APIレート制限

無料プランでは、最大365日分のイベント履歴を含め、1日あたり100回のAPI呼び出しが可能です。各ツールの呼び出しで1〜2回のAPI呼び出しが行われます。上限を引き上げるには、quantgist.com/pricing からアップグレードしてください。

ライセンス

MIT