curistat-mcp

Curistat MCP Server

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