quantoracle — Claude Code MCP server: quant math tools
An MCP server exposing 73 deterministic finance calculators so an agent computes option prices and risk figures instead of guessing them.
claude mcp add quantoracle -- npx -y quantoracle-mcpWhat quantoracle does
LLMs are shaky on formulas like Black-Scholes: run the same prompt twice and the numbers move. quantoracle keeps the math on a remote API and hands the agent tools that take JSON and return JSON. Repeating a call with identical inputs reproduces the result exactly.
The catalog splits into eight groups: options and derivatives, risk (Sharpe, VaR, drawdowns), portfolio work, statistics such as GARCH and cointegration, crypto and DeFi, FX, and macro. Ten composite scenarios sit on top — a backtest, a hedging suggestion, a full risk review, a rebalance plan — and each one packs between 5 and 15 calculator calls into a single reply.
The free tier opens every one of the 73 tools with a per-IP cap: a thousand requests a day, no key. Composite scenarios are paid and settle in USDC over x402 on Base or Solana. Without a configured wallet such a call returns a 402 and stops there; the package itself never spends. Node.js is required because the server starts through npx.
What it helps with
- price an option and its Greeks without relying on model arithmetic
- measure VaR and drawdown on a historical series
- derive mean-variance portfolio weights
- compute liquidation price for a DeFi position
- run a Monte Carlo of withdrawals over a long horizon
Example prompts for the agent
- Price a 30-day NVDA call: strike $185, spot $180, implied vol 28%.
- Run a Monte Carlo on a $100K portfolio over 30 years with 4% withdrawals and tell me the success rate.
- Score this portfolio's risk and suggest a rebalance.
How to install quantoracle
Platform CLI
claude mcp add quantoracle -- npx -y quantoracle-mcpPlatform CLI
codex mcp add mcp-server -- npx -y quantoracle-mcpConfig file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"quantoracle-mcp"
]
}
}
}Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"quantoracle-mcp"
]
}
}
}Platform CLI
gemini mcp add mcp-server npx -y quantoracle-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about quantoracle
How do I install quantoracle in Claude Code?
Run claude mcp add quantoracle -- npx -y quantoracle-mcp. The server then shows up among your MCP servers and its tools become callable.
What does quantoracle do?
It gives the agent finance calculators covering options, risk, portfolio, statistics, crypto, FX and macro. Each one does the arithmetic server-side, so output stays reproducible.
Do I need an API key?
Not for free use. Limits apply per source IP, and the paid composite scenarios need an x402 wallet set through QUANTORACLE_X402_WALLET.
