QuantGist MCP Server
Exposes QuantGist macro-economic event data as Model Context Protocol (MCP) tools so Claude and other AI agents can query calendars, check event proximity, and assess trade safety — all within a conversation.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
uvx quantgist-mcp==0.5.4Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
QUANTGIST_API_KEY=<secret> claude mcp add io.github.quantgist-technologies-quantgist-mcp -- uvx quantgist-mcp==0.5.4รันในเทอร์มินัล
{ "mcpServers": { "io.github.quantgist-technologies-quantgist-mcp": { "command": "uvx", "args": [ "quantgist-mcp==0.5.4" ], "env": { "QUANTGIST_API_KEY": "<secret>" } } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Exposes QuantGist macro-economic event data as Model Context Protocol (MCP) tools so Claude and other AI agents can query calendars, check event proximity, and assess trade safety — all within a conversation.
Macro events, earnings & market data from QuantGist for Claude and other AI agents.
The server registers 22 tools that any MCP-compatible client (Claude Desktop, Claude Code, custom agents) can call:
Macro economic events
Earnings
Markets
Discovery & help (read-only, no API key required)
Account (webhooks, API keys, billing)
Mutating tools follow an explicit human-in-the-loop pattern:
confirm: true required. Called without it, a mutating tool makes no API call and
returns a preview of exactly what would happen, so the agent can get the user's approval first.create_checkout_session never charges anything — it returns a
Stripe-hosted checkout URL that a human must open in a browser and complete. No card data ever
passes through the tool or QuantGist's API. The plan upgrades automatically after payment.The MCP server is hosted over HTTP at https://api.quantgist.com/mcp — no install, no
Python. Any client that supports the streamable-HTTP transport can connect by sending your
QuantGist key in an X-API-Key header (multi-tenant: billed to your own quota).
Claude Code, in one command:
claude mcp add --transport http quantgist https://api.quantgist.com/mcp \
--header "X-API-Key: qg_live_YOUR_KEY"
Any streamable-HTTP MCP client:
{
"mcpServers": {
"quantgist": {
"type": "streamable-http",
"url": "https://api.quantgist.com/mcp",
"headers": { "X-API-Key": "qg_live_YOUR_KEY" }
}
}
}
Connectors that only accept a URL (e.g. ChatGPT): if you can't set a custom header, put the
key in the URL instead — https://api.quantgist.com/mcp?apiKey=qg_live_YOUR_KEY (also accepts
Authorization: Bearer <key>). The header is preferred where possible, since a key in the URL can
be recorded in proxy/server logs.
Prefer to run it yourself? Install locally (below) or self-host the HTTP server — see DEPLOY.md.
pip install quantgist-mcp
# or with uv:
uv pip install quantgist-mcp
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
Locate your Claude Desktop config file:
Add the quantgist server block (see claude_desktop_config_example.json):
{
"mcpServers": {
"quantgist": {
"command": "quantgist-mcp",
"env": {
"QUANTGIST_API_KEY": "qg_live_YOUR_KEY_HERE"
}
}
}
}
Restart Claude Desktop after saving. The tools will appear in the tool list.
uv run instead of a global installIf you prefer not to install globally, point Claude Desktop at 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"
}
}
}
}
Add to .claude/mcp_settings.json in your project (or the global ~/.claude/mcp_settings.json):
{
"mcpServers": {
"quantgist": {
"command": "quantgist-mcp",
"env": {
"QUANTGIST_API_KEY": "qg_live_YOUR_KEY_HERE"
}
}
}
}
Besides the stdio transport above, the server can run as a hosted HTTP service via the
quantgist-mcp-http entry point (GET /health, MCP at /mcp). It accepts a per-request
X-API-Key header (multi-tenant) or a server-side QUANTGIST_API_KEY env var.
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
See DEPLOY.md for Docker, Docker Compose, and Coolify deployment.
get_upcoming_eventsReturns events in the next N hours.
get_events_rangeReturns events in a date range.
get_economic_calendarReturns the day's macro calendar grouped by release time. This tool calls
GET /v1/calendar?envelope=true, not the broad /events feed, so general
financial-news headlines are not mixed into scheduled macro releases.
The structured output preserves the backend envelope:
events / count / returned_counttotal_countcoveragewarningstruncatedschema_versionIf the backend response is partial, stale, truncated by the MCP safety cap, or
missing the required calendar envelope, the tool surfaces that in warnings and
does not fall back to /events.
get_event_detailReturns full detail for one event.
get_earnings_upcomingReturns the next upcoming earnings reports across all tickers, ordered by report date.
get_earnings_for_tickerReturns earnings history for a single ticker (EPS estimate vs actual, revenue, beat/miss, EDGAR links).
get_earnings_summaryReturns beat / miss / in-line counts and overall beat rate for a ticker.
get_earnings_surprisesReturns the largest EPS surprises across the market in the most recent reports.
get_earnings_season_summaryReturns the index-level summary of the current earnings season (total reports, overall beat rate, average EPS surprise, season label). No parameters.
get_markets_overviewReturns end-of-day quotes for major market indices and instruments (S&P 500, Nasdaq, Dow Jones, gold, oil, etc.). No parameters.
get_subscriptionReturns the authenticated account's plan, status, and billing period. No parameters. Read-only.
list_webhooksLists the account's registered webhook endpoints. No parameters. Read-only; webhooks require the Pro plan.
create_webhookRegisters an HTTPS webhook endpoint (Pro plan). Confirm-gated: without confirm: true it returns a preview and makes no API call. The signing secret is returned once only.
delete_webhookPermanently deletes a webhook endpoint and its delivery history. Confirm-gated and destructive.
test_webhookSends a signed synthetic test event to a webhook endpoint so you can verify reachability and X-QuantGist-Signature verification.
create_api_keyCreates a new API key, optionally scoped. Confirm-gated. The full key is returned once only — store it securely.
create_checkout_sessionCreates a Stripe Checkout session for a plan upgrade. Never charges — returns a Stripe-hosted checkout URL a human must open and complete. Confirm-gated.
These prompts work out of the box once the server is connected:
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
The free tier allows 100 API calls/day with up to 365 days of event history. Each tool invocation makes 1–2 API calls. Upgrade at quantgist.com/pricing for higher limits.
MIT
Macro events, earnings & market data from QuantGist for Claude and other AI agents.
{ "mcpServers": { "io.github.quantgist-technologies-quantgist-mcp": { "command": "uvx", "args": [ "quantgist-mcp==0.5.4" ], "env": { "QUANTGIST_API_KEY": "<secret>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: QUANTGIST_API_KEY
QuantGist ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-09 Macro events, earnings & market data from QuantGist for Claude and other AI agents.