TradingCalc MCP Server

Deterministic crypto futures calculations for AI agents and developer integrations.

19 tools: 12 primitives + 16 workflows across 5 families — trade planning (PnL, breakeven, exit target, scenario, DCA entry, scale-out), risk (liquidation, position sizing, max leverage, risk/reward), funding & carry (funding cost, arb, compound, funding breakeven, carry trade setup) + workflow.run_pre_trade_check integrated decision.

Two access surfaces: MCP (Claude Desktop / Cursor / VS Code) and REST API (/v1/primitives, /v1/workflows).

Not estimates — exact numbers your trading bot can trust.

Endpoints

| Surface | URL | Auth | |---|---|---| | MCP | https://tradingcalc.io/api/mcp | Bearer optional | | REST primitives | https://tradingcalc.io/v1/primitives/:id | Bearer required | | REST workflows | https://tradingcalc.io/v1/workflows/:id | Bearer required | | Discovery | https://tradingcalc.io/v1/primitives | None | | Docs | https://tradingcalc.io/docs | None |

MCP transport: Streamable HTTP (MCP spec 2024-11-05)

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "tradingcalc": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://tradingcalc.io/api/mcp"]
    }
  }
}

Cursor / VS Code

{
  "tradingcalc": {
    "url": "https://tradingcalc.io/api/mcp"
  }
}

Direct HTTP

curl -X POST https://tradingcalc.io/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "workflow.run_liquidation_safety",
      "arguments": {
        "side": "long",
        "entryPrice": 95000,
        "leverage": 10
      }
    }
  }'

Tools (19)

Tool naming follows the workflow.run_* / primitive.* / system.* namespace convention. Old flat names (pnl, liquidation, etc.) are accepted for backward compatibility.

Standard Workflows — 5 credits each (via MCP or POST /v1/workflows/:id)

Trade Planning | Tool | REST endpoint | Description | |---|---|---| | workflow.run_pnl_planning | /v1/workflows/pnl-planning | Net PnL, fees and gross profit/loss for a futures trade | | workflow.run_breakeven_planning | /v1/workflows/breakeven-planning | Break-even price accounting for entry/exit fees | | workflow.run_exit_target | /v1/workflows/exit-target | Exit price required to hit a target PnL or ROE | | workflow.run_scenario_planning | /v1/workflows/scenario-planning | Multi-scenario P&L analysis across price targets | | workflow.run_dca_entry | /v1/workflows/dca-entry | DCA across N price levels → avg entry, breakeven, level contribution | | workflow.run_scale_out | /v1/workflows/scale-out | Partial exits at multiple levels → P&L per exit, weighted avg, overall ROI |

Risk & Margin | Tool | REST endpoint | Description | |---|---|---| | workflow.run_liquidation_safety | /v1/workflows/liquidation-safety | Liquidation price for long/short isolated margin | | workflow.run_position_sizing | /v1/workflows/position-sizing | Position size based on account size and max risk % | | workflow.run_max_leverage | /v1/workflows/max-leverage | Maximum safe leverage based on drawdown tolerance and volatility |

Funding & Carry | Tool | REST endpoint | Description | |---|---|---| | workflow.run_funding_cost | /v1/workflows/funding-cost | Cumulative funding cost over a holding period | | workflow.run_funding_arbitrage | /v1/workflows/funding-arbitrage | Annualized yield from long/short basis trades across two exchanges | | workflow.run_compound_funding | /v1/workflows/compound-funding | Capital growth projection from reinvesting funding income | | workflow.run_funding_breakeven | /v1/workflows/funding-breakeven | Price move needed to cover funding cost + fees over holding period |

Advanced Workflows — 8 credits each

| Tool | REST endpoint | Description | |---|---|---| | workflow.run_risk_reward | /v1/workflows/risk-reward | Full R:R analysis: sizing + liquidation + breakeven + P&L at stop and target | | workflow.run_carry_trade | /v1/workflows/carry-trade | Delta-neutral carry setup: net yield, ROI, breakeven days, verdict |

Primitives — 1 credit each (via MCP or POST /v1/primitives/:id)

| Tool | REST endpoint | Description | |---|---|---| | primitive.average_entry | /v1/primitives/average_entry | Average entry price after DCA into a position | | primitive.hedge_ratio | /v1/primitives/hedge_ratio | Short perp size and funding cost to hedge a spot position |

Integrated Decision Workflow — 10 credits

| Tool | REST endpoint | Description | |---|---|---| | workflow.run_pre_trade_check | /v1/workflows/pre-trade-check | Full pre-trade decision: position size, liquidation, breakeven, funding cost, go/no-go signal. Accepts live exchange + symbol. |

System

| Tool | Description | |---|---| | system.verify | Run 22 canonical test vectors against all calculators. Returns pass/fail report. |

Formulas normalized across 7 exchanges: Binance, Bybit, OKX, Hyperliquid, Aster, KuCoin, MEXC.

Rate Limits & Pricing

| Plan | Req/day | Credits/mo | Price | |---|---|---|---| | Anonymous | 20 | — | Free | | Free API key | 200 | — | Free | | Trader | 2,500 | 250 | $19/mo | | Builder | 50,000 | 5,000 | $79/mo | | Team | 250,000 | 25,000 | $249/mo | | Growth | 2,000,000 | 150,000 | $599/mo |

Credits: primitive = 1 cr · standard workflow = 5 cr · advanced workflow = 8 cr · pre-trade-check = 10 cr · verification bundle = +2 cr

Get your API key → email [email protected] or see tradingcalc.io/pricing

Pass key as: Authorization: Bearer <your-api-key>

Self-Verification

Agents can verify all 22 canonical test vectors before trusting results:

{
  "jsonrpc": "2.0", "id": 1,
  "method": "tools/call",
  "params": { "name": "system.verify", "arguments": {} }
}

Response: { "status": "pass", "passed": 22, "failed": 0, "total": 22 }

Live proof: tradingcalc.io/verify

Use Cases

• Trading bots — check liquidation price before every trade
• AI agents — deterministic risk calculations without hallucination risk
• Multi-agent systems — drop-in risk management agent in analyst + risk + execution pipelines
• Dashboards — embed calculations programmatically

Why deterministic?

LLMs asked directly give plausible but potentially wrong numbers. TradingCalc MCP returns exact calculations — same inputs always produce the same outputs. No hallucination risk for financial data.

Links

• API docs: tradingcalc.io/docs
• Pricing: tradingcalc.io/pricing
• Verification proof: tradingcalc.io/verify
• Web calculators: tradingcalc.io
• Telegram Mini App: @perpcalcbot