TradingCalc MCP — Crypto Futures Math
skalinin909/tradingcalc-mcp
Connects Claude to 19 crypto futures calculators that return exact numbers instead of LLM estimates. You get PnL, liquidation prices, position sizing, funding costs, and carry trade analysis with formulas verified against 22 test vectors. Ask naturally and it routes to the right tool: "long BTC at $83k with 10x leverage, where's liquidation?" or "size my position for 1% risk with stop at $81k." Runs over streamable HTTP, so no local install needed. Free tier gives you 20 calls per day anonymous, 200 with an API key. Useful when you're building trading bots or agent pipelines where wrong math costs real money.
- GitHub stars
- 1
- tools
- 19
- last updated
- Apr 8, 2026
Tools
19 toolsPublic tool metadata for what this MCP can expose to an agent.
workflow.run_pnl_planningCalculate net PnL, ROE, fees and gross profit/loss for a futures trade. Use when user asks "what's my profit/loss on this trade?" Returns: grossPnl, fees, netPnl, netPnlUsdt, roe (%).6 params
Calculate net PnL, ROE, fees and gross profit/loss for a futures trade. Use when user asks "what's my profit/loss on this trade?" Returns: grossPnl, fees, netPnl, netPnlUsdt, roe (%).
Parameters* required
entryPricenumberEntry price (positive)
exitPricenumberExit price (positive)
feeClosePctnumberClosing fee as fraction
feeOpenPctnumberOpening fee as fraction, e.g. 0.0002 = 0.02%
sidestringTrade directionone of
long · shortsizenumberPosition size in base asset
workflow.run_liquidation_safetyCalculate the liquidation price for an isolated-margin futures position. Use when user asks "where will I get liquidated?" or "how close is my liq price?". Returns: liquidationPrice, distancePct (how far from entry).4 params
Calculate the liquidation price for an isolated-margin futures position. Use when user asks "where will I get liquidated?" or "how close is my liq price?". Returns: liquidationPrice, distancePct (how far from entry).
Parameters* required
entryPricenumberEntry price (positive)
leveragenumberLeverage multiplier, e.g. 10 for 10x
mmrnumberMaintenance margin rate, default 0.005 (0.5%)
sidestringone of
long · shortworkflow.run_breakeven_planningCalculate the break-even exit price that covers all trading fees. Use when user asks "what price do I need to just break even?" Returns: breakevenPrice, totalFees.5 params
Calculate the break-even exit price that covers all trading fees. Use when user asks "what price do I need to just break even?" Returns: breakevenPrice, totalFees.
Parameters* required
entryPricenumberEntry price (positive)
feeClosePctnumberClosing fee fraction, default 0.0005
feeOpenPctnumberOpening fee fraction, default 0.0002
sidestringone of
long · shortsizeBasenumberPosition size in base asset
workflow.run_position_sizingCalculate the correct position size given a maximum risk in USDT and a stop-loss price. Use when user asks "how many coins should I buy?" or "size my position so I risk exactly $X". Returns: positionSize (base), positionUsdt, marginRequired.7 params
Calculate the correct position size given a maximum risk in USDT and a stop-loss price. Use when user asks "how many coins should I buy?" or "size my position so I risk exactly $X". Returns: positionSize (base), positionUsdt, marginRequired.
Parameters* required
entryPricenumberEntry price
feeClosePctnumberClosing fee fraction, default 0.0005
feeOpenPctnumberOpening fee fraction, default 0.0002
leveragenumberLeverage, default 1
riskUsdtnumberMaximum acceptable loss in USDT
sidestringone of
long · shortstopLossnumberStop-loss price
workflow.run_funding_costCalculate the total funding cost (or income) for holding a perpetual futures position. Use when user asks "how much funding will I pay holding X days?" or "is funding eating my profit?". Returns: totalFundingUsdt (negative = you pay, positive = you receive), perIntervalUsdt.5 params
Calculate the total funding cost (or income) for holding a perpetual futures position. Use when user asks "how much funding will I pay holding X days?" or "is funding eating my profit?". Returns: totalFundingUsdt (negative = you pay, positive = you receive), perIntervalUsdt.
Parameters* required
daysnumberNumber of days to hold
entryPricenumberEntry price
fundingRatenumberFunding rate per 8h period as fraction, e.g. 0.0001
sidestringone of
long · shortsizeBasenumberPosition size in base asset
primitive.average_entryCalculate the weighted average entry price from multiple buy/sell fills (DCA). Use when user has filled at multiple prices and asks "what's my average entry?" Returns: averagePrice, totalSize, totalCost.3 params
Calculate the weighted average entry price from multiple buy/sell fills (DCA). Use when user has filled at multiple prices and asks "what's my average entry?" Returns: averagePrice, totalSize, totalCost.
Parameters* required
exchangeCodestringExchange identifier (optional)
inputobjectsymbolstringTrading pair symbol, e.g. BTCUSDT
workflow.run_exit_targetCalculate the exact exit price needed to hit a target PnL or ROE percentage. Use when user asks "at what price do I take profit to make $500?" or "where should I set TP for 20% ROE?". Returns: targetExitPrice.8 params
Calculate the exact exit price needed to hit a target PnL or ROE percentage. Use when user asks "at what price do I take profit to make $500?" or "where should I set TP for 20% ROE?". Returns: targetExitPrice.
Parameters* required
entryPricenumberEntry price
feeClosePctnumberClosing fee fraction, default 0.0005
feeOpenPctnumberOpening fee fraction, default 0.0002
leveragenumberLeverage multiplier
sidestringone of
long · shortsizeBasenumberPosition size in base asset
targetModestring"pnl" = target in USDT, "roe" = target in %one of
pnl · roetargetValuenumberTarget value (USDT or %)
workflow.run_scenario_planningRun a scenario analysis: compute PnL for multiple price-change percentages at once. Use when user asks "show me my P&L if BTC moves -10%, -5%, +5%, +10%". Returns: array of { deltaPct, exitPrice, netPnl, roe }.6 params
Run a scenario analysis: compute PnL for multiple price-change percentages at once. Use when user asks "show me my P&L if BTC moves -10%, -5%, +5%, +10%". Returns: array of { deltaPct, exitPrice, netPnl, roe }.
Parameters* required
deltasPctarrayList of price change percentages, e.g. [-10, -5, 0, 5, 10]
entryPricenumberEntry price
feeClosePctnumberClosing fee fraction
feeOpenPctnumberOpening fee fraction
sidestringone of
long · shortsizenumberPosition size in base asset
workflow.run_max_leverageCalculate the maximum safe leverage based on account size, max acceptable drawdown, and asset daily volatility. Use when user asks "what's the max leverage I should use on BTC?" or "how much leverage is safe given 3% daily volatility?". Returns: maxLeverage, marginAtRisk.4 params
Calculate the maximum safe leverage based on account size, max acceptable drawdown, and asset daily volatility. Use when user asks "what's the max leverage I should use on BTC?" or "how much leverage is safe given 3% daily volatility?". Returns: maxLeverage, marginAtRisk.
Parameters* required
accountSizenumberTotal account size in USDT
maxDrawdownPctnumberMaximum acceptable drawdown as percentage, e.g. 10 for 10%
mmrnumberMaintenance margin rate, default 0.005 (0.5%)
volatilityPctnumberExpected daily price volatility as percentage, e.g. 3 for 3%
primitive.hedge_ratioCalculate the short perpetual futures position size needed to hedge a spot holding. Use when user asks "how much should I short to hedge my BTC?" or "what margin do I need for a 100% hedge?". Returns: hedgeNotional, requiredMargin, estimatedFundingCost.4 params
Calculate the short perpetual futures position size needed to hedge a spot holding. Use when user asks "how much should I short to hedge my BTC?" or "what margin do I need for a 100% hedge?". Returns: hedgeNotional, requiredMargin, estimatedFundingCost.
Parameters* required
fundingRatePctnumberCurrent 8h funding rate as percentage, e.g. 0.01. Used for cost estimate.
hedgeRationumberPercentage of spot to hedge, e.g. 100 for full hedge, 50 for half. Default 100.
leveragenumberLeverage on the perp short. Default 1.
spotSizenumberSpot position value in USDT
workflow.run_funding_arbitrageCalculate funding rate arbitrage profit: annualized yield, net profit, and breakeven days for a long/short basis trade across two exchanges. Use when user asks "is this funding arb worth it?" or "how many days to break even on transfer fees?". Returns: netProfitUsdt, annualize...6 params
Calculate funding rate arbitrage profit: annualized yield, net profit, and breakeven days for a long/short basis trade across two exchanges. Use when user asks "is this funding arb worth it?" or "how many days to break even on transfer fees?". Returns: netProfitUsdt, annualize...
Parameters* required
durationDaysnumberHolding period in days
intervalHoursnumberFunding interval: 8 (standard) or 1 (Hyperliquid)one of
8 · 1longFundingRatenumberFunding rate on long side (% per interval, positive = you pay)
positionSizenumberPosition size in USDT
shortFundingRatenumberFunding rate on short side (% per interval, positive = you receive)
transferFeePctnumberOne-time transfer/setup fee as percentage, e.g. 0.1 for 0.1%
workflow.run_compound_fundingProject capital growth from reinvesting perpetual futures funding income (compounding carry). Use when user asks "how much will I make compounding 0.01% funding for 90 days?" or "what's my APY on this carry position?". Returns: finalCapital, totalEarned, apy, growthTable.5 params
Project capital growth from reinvesting perpetual futures funding income (compounding carry). Use when user asks "how much will I make compounding 0.01% funding for 90 days?" or "what's my APY on this carry position?". Returns: finalCapital, totalEarned, apy, growthTable.
Parameters* required
durationDaysnumberNumber of days to project
fundingRatePctnumberFunding rate per interval as percentage, e.g. 0.01 for 0.01%
initialCapitalnumberStarting capital in USDT
intervalHoursnumberFunding interval: 8 (standard) or 1 (Hyperliquid)one of
8 · 1reinvestPctnumberPercentage of earnings reinvested each interval. 100 = full compounding, 0 = no reinvestment. Default 100.
workflow.run_pre_trade_checkFull pre-trade decision card: orchestrates position sizing, breakeven, liquidation, and funding cost in one call. Use when user describes a full trade setup and asks "should I take this trade?" or "run the numbers on this setup". Provide exchange+symbol to fetch live funding r...13 params
Full pre-trade decision card: orchestrates position sizing, breakeven, liquidation, and funding cost in one call. Use when user describes a full trade setup and asks "should I take this trade?" or "run the numbers on this setup". Provide exchange+symbol to fetch live funding r...
Parameters* required
account_balancenumberTotal account balance in USDT
entry_pricenumberEntry price (positive)
exchangestringExchange code, e.g. "binance" or "bybit". Used to fetch live funding rate if funding_rate is omitted.
fee_close_pctnumberClosing fee fraction, default 0.0005
fee_open_pctnumberOpening fee fraction, default 0.0002
funding_ratenumberFunding rate per 8h as decimal, e.g. 0.0001. If omitted, fetched live from exchange.
hold_hoursnumberExpected hold time in hours for overnight shift calc. Default 8.
leveragenumberLeverage multiplier
mmrnumberMaintenance margin rate, default 0.005
risk_pctnumberRisk as % of balance, e.g. 1.0 = 1%
sidestringone of
long · shortstop_lossnumberStop-loss price (positive)
symbolstringPerpetual symbol, e.g. "BTCUSDT".
workflow.run_risk_rewardFull risk:reward analysis — the single best tool when user describes a trade with entry, stop, and target. Calculates R:R ratio, position size, liquidation price, breakeven, and P&L at both stop and target. Returns a verdict: strong (3:1+) / good (2:1+) / marginal / poor. Use...10 params
Full risk:reward analysis — the single best tool when user describes a trade with entry, stop, and target. Calculates R:R ratio, position size, liquidation price, breakeven, and P&L at both stop and target. Returns a verdict: strong (3:1+) / good (2:1+) / marginal / poor. Use...
Parameters* required
account_balancenumberAccount balance in USDT
entry_pricenumberEntry price
fee_close_pctnumberClose fee rate (default 0.0005)
fee_open_pctnumberOpen fee rate (default 0.0002)
leveragenumberLeverage multiplier
mmrnumberMaintenance margin rate (default 0.005)
risk_pctnumberMax risk as % of account
sidestringone of
long · shortstop_lossnumberStop-loss price
take_profitnumberTake-profit price
workflow.run_dca_entryDCA entry planner: weighted average entry price, breakeven, and per-level contribution from multiple fill prices and sizes. Use when user bought at several prices and asks "what's my average entry?" or "where is my DCA breakeven?". Returns: averageEntry, breakeven, per-level s...4 params
DCA entry planner: weighted average entry price, breakeven, and per-level contribution from multiple fill prices and sizes. Use when user bought at several prices and asks "what's my average entry?" or "where is my DCA breakeven?". Returns: averageEntry, breakeven, per-level s...
Parameters* required
entriesarrayfee_close_pctnumberClose fee rate (default 0.0005)
fee_open_pctnumberOpen fee rate (default 0.0002)
sidestringone of
long · shortworkflow.run_scale_outScale-out planner: P&L, ROI, and cumulative P&L for each partial exit level. Use when user wants to take profit at multiple targets — "close 30% at $90k, 30% at $95k, 40% at $100k — what's my total P&L?". Returns: per-level pnl, weightedAvgExitPrice, totalRoi.6 params
Scale-out planner: P&L, ROI, and cumulative P&L for each partial exit level. Use when user wants to take profit at multiple targets — "close 30% at $90k, 30% at $95k, 40% at $100k — what's my total P&L?". Returns: per-level pnl, weightedAvgExitPrice, totalRoi.
Parameters* required
entry_pricenumberEntry price
exitsarrayfee_close_pctnumberClose fee rate (default 0.0005)
fee_open_pctnumberOpen fee rate (default 0.0002)
sidestringone of
long · shorttotal_sizenumberTotal position size in base currency
workflow.run_carry_tradeDelta-neutral carry trade (funding arbitrage) analysis. Use when user asks "is this carry trade worth it?" — long on exchange A, short on exchange B, collect the funding rate spread. Returns: netYieldPct, grossProfit, netProfit, breakevenDays, verdict (profitable/marginal/loss).6 params
Delta-neutral carry trade (funding arbitrage) analysis. Use when user asks "is this carry trade worth it?" — long on exchange A, short on exchange B, collect the funding rate spread. Returns: netYieldPct, grossProfit, netProfit, breakevenDays, verdict (profitable/marginal/loss).
Parameters* required
funding_rate_longnumberFunding rate on long exchange per interval (decimal)
funding_rate_shortnumberFunding rate on short exchange per interval (decimal)
hold_daysnumberHold duration in days
interval_hoursnumberFunding interval: 1 or 8 hours (default 8)one of
1 · 8notionalnumberPosition notional in USDT
transfer_fee_pctnumberOne-way transfer fee % (default 0.1)
workflow.run_funding_breakevenPrice move needed to cover funding cost + fees over a holding period. Use when user asks "how much does BTC need to move for me to profit after funding?" or "is funding killing my edge on this trade?". Returns: breakevenWithFunding, breakevenWithoutFunding, requiredMovePct.7 params
Price move needed to cover funding cost + fees over a holding period. Use when user asks "how much does BTC need to move for me to profit after funding?" or "is funding killing my edge on this trade?". Returns: breakevenWithFunding, breakevenWithoutFunding, requiredMovePct.
Parameters* required
entry_pricenumberEntry price
fee_close_pctnumberClose fee rate (default 0.0005)
fee_open_pctnumberOpen fee rate (default 0.0002)
funding_ratenumberFunding rate per 8h period (decimal, e.g. 0.0001)
hold_hoursnumberHold duration in hours
sidestringone of
long · shortsizenumberPosition size in base currency
system.verifyRun the full regression suite — 22 canonical test vectors across all 12 calculators — and return a pass/fail report with counts and timestamp. Call this before using results in production workflows to confirm the computation layer is operating correctly.
Run the full regression suite — 22 canonical test vectors across all 12 calculators — and return a pass/fail report with counts and timestamp. Call this before using results in production workflows to confirm the computation layer is operating correctly.
No parameter schema in public metadata yet.
Sponsors
Readme
TradingCalc MCP Server
An LLM guesses trading maths. This server computes it: the same inputs always return the same numbers, every result carries a signature you can check, and the core formulas are tested against public vectors (live count in the badge above).
Your question MCP tool call Result
+------------------+ +---------------------------+ +---------------------------+
| "Risk $200 on | ► | workflow.run_forex_ | ► | 0.67 lots, plus an ECDSA |
| EUR/USD with a | | position_size_live | | P-256 signature you can |
| 30 pip stop" | | (deterministic maths) | | verify offline |
+------------------+ +---------------------------+ +---------------------------+
Ask Claude, Cursor or any MCP client trade questions and get exact numbers back, not guesses:
"What should a BTC call at a $90k strike, 30 days out, with 55% implied volatility be worth?" "How many lots of EUR/USD should I trade to risk $200 with a 30-pip stop?" "What's my 95% Value at Risk on this monthly return series?" "What's my PnL if I buy 0.5 BTC at $80k and sell at $95k with 5x leverage?"
What it covers (91 tools)
| Domain | Examples |
|---|---|
| Options | Black-Scholes price and Greeks (manual, or checked live against a Deribit BTC/ETH option), payoff and breakeven, straddle and strangle, vertical spreads, covered call and protective put, implied volatility |
| Forex | Position size from a risk amount, pip value, margin, swap cost, currency conversion, pair correlation, with live-rate variants for the account currency |
| Risk and statistics | VaR and CVaR, Sharpe with the Lo 2002 correction, Deflated Sharpe, Kelly frontier, GARCH(1,1), risk parity, Hurst exponent, cointegration, portfolio tearsheet, EVT tail risk |
| Prediction markets | Odds and vig, market-implied odds, edge sizing, spread and arbitrage checks across Kalshi, Polymarket, Limitless and Myriad |
| On-chain | Solana token and wallet checks, swap price impact, pump.fun bonding curve, impermanent loss |
| Crypto spot | Profit or loss on a coin bought and sold outright, after both fees |
| Crypto futures | PnL, liquidation price, breakeven, funding cost, position size, risk/reward, linear and coin-margined contracts |
Access via MCP (Claude Desktop, Cursor, VS Code and other clients) or a plain HTTP POST to the MCP endpoint. No signup. The server is remote, so nothing to install beyond a one-line client config; only the Claude Desktop bridge below needs Node.js 18 or newer.
Endpoints
| Surface | URL | Auth |
|---|---|---|
| MCP | https://tradingcalc.io/api/mcp | Bearer optional (free) |
| For agents / setup | https://tradingcalc.io/for-agents | None |
| Full API & MCP reference | https://docs.tradingcalc.io/api | None |
| Verification proof | https://tradingcalc.io/verify | None |
MCP transport: Streamable HTTP (MCP spec 2024-11-05)
Quick Start
One command or one config entry per client. Prerequisites: an MCP client; Node.js 18 or newer only for the Claude Desktop bridge and the skill installer. No account, no API key.
| Client | Install |
|---|---|
| Claude Code | claude mcp add --transport http tradingcalc https://tradingcalc.io/api/mcp |
| Gemini CLI | gemini extensions install https://github.com/SKalinin909/tradingcalc-mcp |
| Coding agents with skills (Claude Code, Cursor, Copilot) | npx skills add SKalinin909/tradingcalc-mcp |
| Claude Desktop, Cursor, VS Code | config entry below |
| Cline | "type": "streamableHttp" config entry, see "Cline" below |
| Any other client | plain HTTP POST, see "Direct HTTP" below |
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"
}
}
Cline
Add to cline_mcp_settings.json (MCP Servers, Configure). Set type explicitly: without it Cline reads the URL as the legacy SSE transport.
{
"mcpServers": {
"tradingcalc": {
"type": "streamableHttp",
"url": "https://tradingcalc.io/api/mcp"
}
}
}
No API key and no npx step. Setup notes for agents are in llms-install.md.
Agent Skill
For coding agents that support the skills.sh ecosystem (Claude Code, Cursor,
GitHub Copilot, and others) - installs a SKILL.md that teaches the agent when to reach for these
tools instead of estimating trade math itself:
npx skills add SKalinin909/tradingcalc-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
}
}
}'
Example prompts
After connecting, just ask naturally: the AI picks the right tool automatically:
Options payoff
"What does my BTC call payoff at $90,000? Strike $85,000, premium 0.02 BTC, long 1 contract."
Black-Scholes / IV check
"Is Deribit's BTC-27FEB27-90000-C fairly priced right now?"
Covered call yield
"I hold BTC bought at $80,000. What annualized yield do I get selling a $85,000-strike call for 0.02 BTC, 30 days out?"
Forex pip value
"What's a pip worth on 2 lots of EUR/USD, in my USD account?"
Forex position size
"How many lots should I trade to risk $200 on EUR/USD with a 30-pip stop?"
Forex margin level
"My equity is $5,000 and used margin is $1,800. How close am I to a margin call?"
Value at Risk
"What's my 95% Value at Risk and expected shortfall on this monthly return series? [paste returns]"
Sharpe ratio
"What's the Sharpe ratio of these monthly returns, corrected for autocorrelation?"
Cointegration
"Are these two price series cointegrated? Is there a pairs trade?"
Odds converter
"What odds does a 35% probability work out to?"
Market-implied odds
"What does the market think BTC will be worth by year end?"
Prediction market edge
"I think this event is 60% likely but the market prices it at 40%. Should I bet, and how much with a $10k bankroll?"
Token safety check
"Is this Solana token a rug pull risk? Mint: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
Swap price impact
"How much slippage will I eat swapping 50,000,000 BONK to USDC?"
Bonding curve
"How many tokens do I get buying with 1 SOL on a pump.fun curve that's already raised 20 SOL?"
Market cap comparison
"If I put $1,000 into BONK and it reaches JUP's market cap, what's it worth?"
Wallet flag check
"Is this wallet address flagged for anything? [address]" (Solana or EVM)
Trade P&L
"I bought 0.5 BTC at $80,000 and want to sell at $95,000 with 5x leverage. What's my net profit after fees?"
Position sizing
"I have a $10,000 account and want to risk 1% going long BTC at $83,000 with a stop at $81,000. How many coins should I buy?"
Liquidation check
"Long ETH at $3,200 with 10x leverage, where do I get liquidated?"
Full pre-trade check
"Analyze this setup: long BTC at $83,000, stop $81,000, target $90,000, $10k account, 1% risk, 5x leverage. Is it worth taking?"
Funding cost
"I'm holding 0.5 BTC long on Bybit at $83,000 with 0.01% funding rate. How much will funding cost me over 3 days?"
Carry trade
"Is this carry trade worth it? Long on Bybit at 0.01% funding, short on Binance at 0.05%, $50k notional, 30 days."
DCA average entry
"I bought BTC at $78k (0.2 BTC), $80k (0.3 BTC), and $82k (0.1 BTC). What's my average entry and breakeven?"
Scale-out plan
"I'm long 1 BTC from $80k. I want to close 30% at $88k, 40% at $92k, 30% at $96k. What's my total P&L?"
Tools (91)
Tool naming follows the workflow.run_* / primitive.* / system.* namespace convention.
Old flat names (pnl, liquidation, etc.) are accepted for backward compatibility. All tools are
free via MCP, no signup; 100 calls/day anonymously, 200/day with a free API key.
| Category | Tools |
|---|---|
| Options (Deribit BTC/ETH, coin-settled) | Options payoff & breakeven, Black-Scholes price/Greeks (manual + live), higher-order Greeks (vanna, vomma, charm, veta, speed, zomma, color), straddle/strangle, vertical spread & iron condor, covered call/protective put, implied volatility solver (7) |
| Forex (quote-currency + live account-currency conversion) | Pip value, margin level, breakeven, PnL, risk/reward, scenario, average entry, position size, margin required, currency converter, swap/rollover cost, correlation/hedge ratio: manual + live-FX-rate variants (17) |
| Risk/Stats | VaR/CVaR (+ Modified VaR), Sharpe ratio (Lo 2002 + PSR), Hurst exponent, cointegration, portfolio tearsheet, GARCH(1,1), risk parity, Deflated Sharpe Ratio, Kelly growth-security frontier, return unsmoothing, EVT tail risk, order-book impact (12) |
| Prediction Markets (Kalshi, Polymarket, Limitless, Myriad, ADI Predictstreet crypto categories) | Odds converter, market-implied odds, prediction-market edge, window fair value, cross-venue spread reader, cross-venue arbitrage (6) |
| On-chain (Solana + 5 EVM chains, per tool) | Token risk check, swap price impact, bonding curve, market cap comparison, wallet flag check, impermanent loss (manual + live) (7) |
| Trade Planning | PnL, break-even, exit target, scenario, DCA entry, scale-out, average down (7) |
| Risk & Margin | Liquidation safety, position sizing, max leverage, risk/reward (4) |
| Funding & Carry | Funding cost, funding arbitrage, compound funding, funding break-even, carry trade (5) |
| Market Structure (Market Profile) | Open analysis, session structure, value migration, breakout acceptance (4) |
| Primitives | Average entry, hedge ratio (2) |
| Crypto spot | Crypto profit: profit or loss on a spot trade after both fees (1) |
| Cross-exchange | Price consensus: how far one perpetual futures price sits from 7 reference exchanges (1) |
| Integrated Decision | Pre-trade check (sizing + liquidation + breakeven + funding + go/no-go in one call), portfolio risk review (2) |
| System | system.verify - run the canonical test vectors, get a pass/fail report; system.pubkey - get the public key to verify signed responses offline (2) |
Full tool-by-tool reference (every input/output schema, request/response examples, per-tool descriptions): docs.tradingcalc.io/api
Formulas normalized across 17 exchanges: Binance, OKX, Bybit, Aster, Hyperliquid, MEXC, KuCoin, Gate, Deribit, Kraken, HTX, WOO, Phemex, Blofin, Backpack, dYdX, Polymarket Perps.
Rate Limits
| Access | Req/day | Price |
|---|---|---|
| Anonymous | 100 | Free |
| Free API key | 200 | Free |
The Service is free. Need a higher-limit key? Email s@tradingcalc.io.
Pass key as: Authorization: Bearer <your-api-key>
Self-Verification
Agents can verify all the canonical test vectors before trusting results:
{
"jsonrpc": "2.0", "id": 1,
"method": "tools/call",
"params": { "name": "system.verify", "arguments": {} }
}
Response: { "status": "pass", "passed": N, "failed": 0, "total": N }, where N is the current number of canonical vectors (live count in the badge at the top).
Live proof: tradingcalc.io/verify
Signed Responses
system.verify proves the formulas are correct. It doesn't prove the specific response you got
wasn't altered by a proxy, cache, or MITM in between. Every tools/call result carries a second
content block signed with ECDSA P-256, plus X-TradingCalc-Signature/Kid/Signed-At headers.
Call system.pubkey (or GET /api/mcp/pubkey) for the public key (PEM + JWK) and the canonical
string format needed to verify offline, no callback required.
Once a day the verification state is also signed and its SHA-256 is written to Solana mainnet in a Memo transaction (tcalc1 {date} {hash}), each record carrying the hash of the day before. Read the records at GET https://tradingcalc.io/api/anchors; the latest record and how to verify it yourself are at tradingcalc.io/verification.
Use Cases
- Options and forex desks: price an option, size a forex position, or check margin level in one exact call
- Quant research: Sharpe, VaR, cointegration and drawdown statistics from a return series, cross-checked against reference libraries
- 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.
Risk Agent Wrapper
examples/risk-agent-wrapper.ts: a drop-in TypeScript wrapper for risk-gated trade execution.
Integrates with any agent framework (ElizaOS, CrewAI, AutoGen, Hummingbot, Freqtrade).
import { RiskAgent, preTradeGate } from './examples/risk-agent-wrapper';
const agent = new RiskAgent({ apiKey: 'tc_your_key', minLiqDistancePct: 3.0 });
const result = await agent.evaluate({
symbol: 'BTCUSDT', exchange: 'bybit',
side: 'long', entry_price: 83000, stop_loss: 81000,
account_balance: 10000, risk_pct: 1, leverage: 5,
funding_rate: 0.0001, hold_hours: 24,
});
if (result.approved) {
// execute trade: result.recommended_size, result.liquidation_price
} else {
console.log('Rejected:', result.rejection_reason);
}
// Binary gate for execution bots
const ok = await agent.isSafe({ symbol: 'ETHUSDT', side: 'short', ... });
// Standalone function (minimal integration)
const { approved, size, liqPrice } = await preTradeGate({ ... }, 'tc_your_key');
TypeScript SDK
For code-first integrations, use tradingcalc-sdk instead of raw JSON-RPC:
npm install tradingcalc-sdk
import { TradingCalcClient } from 'tradingcalc-sdk';
const tc = new TradingCalcClient({ apiKey: 'tc_your_key' });
// Workflows: orchestrated decisions
const check = await tc.workflows.preTradeCheck({ side: 'long', entry_price: 83000, leverage: 5, funding_rate: 0.0001, account_balance: 5000 });
// Primitives: single formula
const avg = await tc.primitives.averageEntry({ symbol: 'BTCUSDT', input: { fills: [{ price: 83000, quantity: 0.1 }] } });
// System
const report = await tc.system.verify();
tc.call() is available for raw MCP access. Full docs: npmjs.com/package/tradingcalc-sdk
Links
- For agents: tradingcalc.io/for-agents
- Full docs (API & MCP reference, methodology, architecture, changelog): docs.tradingcalc.io
- Verification proof: tradingcalc.io/verify
- Web calculators: tradingcalc.io
Details
- Repository
- github.com/skalinin909/tradingcalc-mcp
- Category
- Finance & Commerce
- Transport
- HTTP
- Registry
- MCP registry, active
