Skip to main content

Curistat MCP Server

MCP Server Glama PyPI License: MIT

Futures-specific volatility intelligence for AI agents via the Model Context Protocol.

The first MCP server dedicated to futures volatility analytics. Provides forecasts, regime detection, rare signals, directional bias, and research tools for ES, NQ, and related products.

Quick Start

1. Install

pip install curistat-mcp

2. Get a Curistat API key

Sign up at curistat.com/developer and generate an API key.

3. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "curistat": {
      "command": "python",
      "args": ["-m", "curistat_mcp"],
      "env": {
        "CURISTAT_API_KEY": "cst_agent_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. You can now ask Claude questions like:

  • "What's the volatility forecast for ES today?"
  • "Are there any rare signals firing for NQ?"
  • "Show me the economic calendar for next week"
  • "Find historical days similar to today for ES"

Available Tools

Core Intelligence

Tool Description
get_forecast_today Daily volatility forecast (1-10 rating) with expected move ranges
get_forecast_week 5-day forward volatility forecast
get_signals Scan all 24 rare volatility signals
get_direction Directional bias (17-component aggregate)
get_session_plan Full session planner with trade setups

Regime

Tool Description
get_regime CRC composite (0-100, 5 bands)
get_pulse Market conditions snapshot

Research

Tool Description
get_calendar Economic calendar with vol impact estimates
get_event_impact Historical vol analysis around specific events
get_similar_days Historical analog day lookup

Supported Products

ES, NQ, MES, MNQ, SPX, SPY, QQQ

Agent Framework Integration

CrewAI

from crewai import Agent
from crewai_tools import MCPTool

curistat_tools = MCPTool(
    server_command="python",
    server_args=["-m", "curistat_mcp"],
    server_env={"CURISTAT_API_KEY": "cst_agent_..."},
)

analyst = Agent(
    role="Futures Volatility Analyst",
    tools=[curistat_tools],
    goal="Analyze market conditions and provide trading intelligence",
)

LangChain

from langchain_mcp import MCPToolkit

toolkit = MCPToolkit(
    server_command="python",
    server_args=["-m", "curistat_mcp"],
    server_env={"CURISTAT_API_KEY": "cst_agent_..."},
)

tools = toolkit.get_tools()

Direct stdio (any MCP client)

CURISTAT_API_KEY=cst_agent_... python -m curistat_mcp

The server communicates via stdio using the MCP protocol.

Environment Variables

Variable Required Default Description
CURISTAT_API_KEY Yes -- Your Curistat Developer API key
CURISTAT_API_URL No https://api.curistat.com API base URL

Rate Limits

Rate limits are enforced by your API key tier, not by the MCP server. The server is a thin client that proxies requests to the Curistat API.

Tier Requests/min Requests/day
Free 10 100
Pro 60 5,000
Agent 120 50,000

License

MIT

Metadata

Release files for curistat-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for curistat-mcp 0.1.1
File Size Uploaded Provenance
curistat_mcp-0.1.1.tar.gz 6.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for curistat-mcp 0.1.1
File Interpreter ABI Platform
curistat_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 12.5 kB

Release files / curistat_mcp-0.1.1.tar.gz

Download URL curistat_mcp-0.1.1.tar.gz
Size 6.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e405eaa3fb967c2a1e6ceaa3c45808477413dc545ff1d1761518df5f2f50ff03
BLAKE2b-256 checksum
How to use checksums
681cda9d5ff9329479d547baa34a57a4faf37a8e824e0124baba038dbabf2c54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / curistat_mcp-0.1.1-py3-none-any.whl

Download URL curistat_mcp-0.1.1-py3-none-any.whl
Size 6.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c972ec31a7fffe574ff71196e4271ee77730b8ce84e98980db1e2a8f432b0d7f
BLAKE2b-256 checksum
How to use checksums
278e4c12c141395a5ac0c4bfe8a771eeb55115b03eecbf940b23e40d9a5a7916
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for curistat-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page