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
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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| curistat_mcp-0.1.1.tar.gz | 6.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.