Provides AI agents with 73 deterministic quantitative finance calculators for options pricing, risk metrics, portfolio optimization, and more.
Also known as QuantOracledev/quantoracle, quantoracle-e3af91, quantoracle-mcp
- Stars
- 14
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.4.2
- Last commit
- Nov 13, 2026
- License
- MIT
What is quantoracle MCP?
quantoracle provides AI agents with 73 deterministic quantitative finance calculators for options pricing, risk metrics, portfolio optimization, and more.
Summary generated from the project's README
About quantoracle MCP server
QuantOracle provides AI agents with access to 73 deterministic quantitative finance calculators through a thin MCP transport layer. This server enables clients like Claude, ChatGPT, Cursor, and Cline to perform complex financial computations by calling the QuantOracle API as native tools. The system is designed for developers and traders who need consistent, repeatable mathematical outputs for options pricing, risk metrics, portfolio optimization, and various statistical models.
Users can run the server locally using npx without requiring an API key for the free tier, which allows up to 1,000 calls per IP per day. For more advanced workflows, such as backtesting or full risk analysis, the server supports paid composite endpoints. These premium calls are processed via the x402 protocol on Base or Solana mainnet. The server remains safe for experimentation because it never spends money automatically; if a paid endpoint is called without a configured x402 wallet, it simply returns a 402 error.
What you can do with it
- 1Calculate options pricing and GreeksAsk an AI agent to determine the price and delta of a specific stock option call.
- 2Perform portfolio risk simulationsRequest a Monte Carlo simulation to find the success rate of a long-term investment strategy.
- 3Execute complex financial workflowsUse composite tools to generate a complete rebalancing plan for a portfolio.
- 4Analyze cryptocurrency market metricsCalculate the potential impact of impermanent loss or liquidation prices in DeFi.
Written from the project's README. Every use case is checked against a quote from it.
How to install quantoracle MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall quantoracle MCP in Claude Code
$ claude mcp add quantoracle-e3af91 -- npx -y quantoracle-mcpInstall quantoracle MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"quantoracle-e3af91": {
"command": "npx",
"args": [
"-y",
"quantoracle-mcp"
]
}
}
}Install quantoracle MCP in VS Code
.vscode/mcp.json
{
"servers": {
"quantoracle-e3af91": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"quantoracle-mcp"
]
}
}
}Install quantoracle MCP in VS Code CLI
$ code --add-mcp '{"name":"quantoracle-e3af91","type":"stdio","command":"npx","args":["-y","quantoracle-mcp"]}'Install quantoracle MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"quantoracle-e3af91": {
"command": "npx",
"args": [
"-y",
"quantoracle-mcp"
]
}
}
}Install quantoracle MCP in Codex
$ codex mcp add quantoracle-e3af91 -- npx -y quantoracle-mcpInstall quantoracle MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.quantoracle-e3af91] command = "npx" args = ["-y", "quantoracle-mcp"]
Install quantoracle MCP in Gemini CLI
$ gemini mcp add -s user quantoracle-e3af91 npx -- -y quantoracle-mcpInstall quantoracle MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"quantoracle-e3af91": {
"command": "npx",
"args": [
"-y",
"quantoracle-mcp"
]
}
}
}Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubquantoracle-mcp
Model Context Protocol (MCP) server exposing 73 deterministic quant finance calculators to AI agents — Claude, ChatGPT, Cursor, Cline, or any MCP-compatible client. Every tool accepts JSON and returns JSON. Same inputs always produce the same outputs.
The math runs on the QuantOracle API; this package is the thin MCP transport layer that lets your agent call those endpoints as native tools.
Try the calculators in your browser first: the same engine powers 12 free interactive calculators at quantoracle.dev — useful for verifying outputs before wiring the MCP server into your agent.
What's included
73 deterministic financial computation tools across 8 categories:
| Category | Examples |
|---|---|
| Options pricing | Black-Scholes, implied vol, payoff diagrams, multi-leg strategies |
| Derivatives | Binomial trees, barrier, Asian, lookback, volatility surface |
| Risk metrics | Sharpe, Sortino, VaR, CVaR, drawdown, Kelly, position sizing |
| Portfolio | Mean-variance optimization, risk parity, rebalancing, health scoring |
| Statistics | Regression, cointegration, Hurst, GARCH, distribution fits |
| Crypto / DeFi | Impermanent loss, liquidation price, funding rate, DEX slippage |
| FX | Interest rate parity, PPP, carry trade, forwards |
| Macro / TVM | Taylor Rule, real yield, NPV, IRR, CAGR |
Plus 10 composite workflows that bundle 5-15 calculator calls in a single response: backtest, hedging recommendations, full risk analysis, rebalance planning, options strategy optimizer, etc.
Install
npx quantoracle-mcp
Or install globally:
npm install -g quantoracle-mcp
quantoracle-mcp
Configure (Claude Desktop)
Add to your claude_desktop_config.json:
{
"mcpServers": {
"quantoracle": {
"command": "npx",
"args": ["-y", "quantoracle-mcp"]
}
}
}
Configure (Cursor / Cline / Continue)
In your MCP settings, add:
- Command:
npx - Arguments:
-y quantoracle-mcp - Environment: none required for the free tier
Pricing
| Tier | What you get | What it costs |
|---|---|---|
| Free | All 73 endpoints, 1,000 calls per IP per day, no signup, no API key | $0 |
| Paid (x402) | Beyond the free tier; required for the 10 paid composite endpoints | $0.002–$0.10 USDC per call depending on complexity |
Paid calls settle automatically via the x402 protocol on Base mainnet or Solana mainnet. The MCP client (or wrapping framework) is responsible for handling the 402 Payment Required response and retrying with payment headers.
Default behavior: the package never spends money on its own. If a paid endpoint is called and no x402-capable wallet is wired into the client, the call returns a 402 error and exits cleanly. No automatic billing, no surprise charges.
Free-tier endpoints (calculator-only): every endpoint priced $0.002–$0.015. These are the bulk of the 73 endpoints and cover almost any quant-finance use case.
Paid-only endpoints (composites): /v1/risk/full-analysis, /v1/hedging/recommend, /v1/backtest/strategy, /v1/portfolio/rebalance-plan, /v1/options/strategy-optimizer, /v1/options/spread-scan, /v1/trade/evaluate, /v1/portfolio/health, /v1/pairs/signal, /v1/indicators/regime-classify. These wrap many calculator calls and are priced $0.04–$0.10.
Optional environment variables
| Variable | Default | Purpose |
|---|---|---|
QUANTORACLE_API_URL |
https://api.quantoracle.dev |
Override the API endpoint (e.g. for staging or self-hosted) |
QUANTORACLE_X402_WALLET |
(none) | If set, the server enables x402 payment for paid endpoints. Without this variable, paid endpoints return 402 and the agent receives a clean error |
No QUANTORACLE_API_KEY is required for the free tier. The free tier is rate-limited per source IP, not per account.
Example — Claude Desktop session
After installing, ask Claude:
"Price a 30-day NVDA call with strike $185, spot $180, IV 28%."
Claude calls the options/price tool. Response:
Price: $4.92
Greeks: Δ 0.43, Γ 0.043, ν 0.21, Θ -0.034, ρ 0.12
Breakeven: $189.92
Or:
"Run a Monte Carlo simulation: $100K portfolio, 30 years, 7% return, 16% vol, 4% withdrawal. What's the success rate?"
Claude calls simulate/montecarlo. Response includes terminal-value distribution (P5/P25/median/P75/P95), probability of loss, probability of ruin, and CAGR.
Resources
- Browser calculators: https://quantoracle.dev (12 free calculators)
- Full API documentation: https://api.quantoracle.dev/openapi.json
- Endpoint catalog: https://api.quantoracle.dev/tools
- Source repository: https://github.com/QuantOracledev/quantoracle
- x402 protocol: https://x402.org
- Issues: https://github.com/QuantOracledev/quantoracle/issues
License
MIT. See LICENSE.
quantoracle MCP questions
How do I add quantoracle MCP to Claude Code?
Run claude mcp add quantoracle-e3af91 -- npx -y quantoracle-mcp in your terminal. Add --scope user to make it available in every project.
How do I add quantoracle MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need an API key to use the free tier?
No, the free tier does not require a signup or an API key and is rate-limited per source IP.