mcp server
TradingCalc MCP — Crypto Futures Math
Crypto futures math: PnL, liquidation, position sizing, carry trade. 19 tools. Not AI estimates.
Description as published by the maintainer. Source
- version 1.5.2
- slowing
slowing — Registry entry last updated 2026-04-08.
What this server can do
23 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.
primitive.average_entry(input, symbol, exchangeCode)- 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. Required: symbol, input.
primitive.hedge_ratio(leverage, spotSize, hedgeRatio, fundingRatePct)- 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. Required: spotSize.
system.verify- 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.
workflow.run_breakeven_planning(side, sizeBase, entryPrice, feeOpenPct, feeClosePct)- 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. Required: side, entryPrice, sizeBase.
workflow.run_breakout_acceptance(venue, candles, timeframe, instrument, prev_candles, session_date, include_delta, value_area_rule)- Market Profile breakout acceptance — did price accept (hold) beyond the value area / range, or reject back inside (fakeout)? Optional buy/sell delta. Use for "did the break above VAH get accepted?". Required: instrument, venue, session_date.
workflow.run_carry_trade(notional, hold_days, interval_hours, transfer_fee_pct, funding_rate_long, funding_rate_short)- 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). Required: notional, funding_rate_long, funding_rate_short, hold_days.
workflow.run_compound_funding(reinvestPct, durationDays, intervalHours, fundingRatePct, initialCapital)- 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. Required: initialCapital, fundingRatePct, durationDays.
workflow.run_dca_entry(side, entries, fee_open_pct, fee_close_pct)- 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 summary. Required: side, entries.
workflow.run_exit_target(side, leverage, sizeBase, entryPrice, feeOpenPct, targetMode, feeClosePct, targetValue)- 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. Required: side, entryPrice, leverage, sizeBase, targetMode, targetValue.
workflow.run_funding_arbitrage(durationDays, positionSize, intervalHours, transferFeePct, longFundingRate, shortFundingRate)- 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, annualizedYieldPct, breakevenDays. Required: positionSize, longFundingRate, shortFundingRate, durationDays.
workflow.run_funding_breakeven(side, size, hold_hours, entry_price, fee_open_pct, funding_rate, fee_close_pct)- 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. Required: side, entry_price, size, funding_rate, hold_hours.
workflow.run_funding_cost(days, side, sizeBase, entryPrice, fundingRate)- 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. Required: side, sizeBase, entryPrice, fundingRate, days.
workflow.run_liquidation_safety(mmr, side, leverage, entryPrice)- 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). Required: side, entryPrice, leverage.
workflow.run_max_leverage(mmr, accountSize, volatilityPct, maxDrawdownPct)- 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. Required: accountSize, maxDrawdownPct, volatilityPct.
workflow.run_open_analysis(venue, candles, timeframe, instrument, prev_candles, session_date, value_area_rule)- Market Profile open analysis — where and how price opened vs the prior session value area. Returns open location, open type (OD/OTD/ORR/OAIR), key levels (VAH/VAL/VPOC/IB), and bullish/bearish/neutral scenario framing. Use for "how did BTC open today?" / "what does the open imply for the session?". Required: instrument, venue, session_date.
workflow.run_pnl_planning(side, size, exitPrice, entryPrice, feeOpenPct, feeClosePct)- 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 (%). Required: side, entryPrice, exitPrice, size.
workflow.run_position_sizing(side, leverage, riskUsdt, stopLoss, entryPrice, feeOpenPct, feeClosePct)- 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. Required: side, entryPrice, stopLoss, riskUsdt.
workflow.run_pre_trade_check(mmr, side, symbol, exchange, leverage, risk_pct, stop_loss, hold_hours, entry_price, fee_open_pct, funding_rate, fee_close_pct, account_balance)- 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 rate automatically. Returns: positionSize, breakeven, liquidationPrice, fundingCost, overnightBreakevenShift, verdict. Required: side, entry_price, stop_loss, account_balance, risk_pct, leverage.
workflow.run_risk_reward(mmr, side, leverage, risk_pct, stop_loss, entry_price, take_profit, fee_open_pct, fee_close_pct, account_balance)- 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 when user asks "is this trade worth taking?" or "what's my risk reward on this setup?". Required: side, entry_price, stop_loss, take_profit, account_balance, risk_pct, leverage.
workflow.run_scale_out(side, exits, total_size, entry_price, fee_open_pct, fee_close_pct)- 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. Required: side, entry_price, total_size, exits.
workflow.run_scenario_planning(side, size, deltasPct, entryPrice, feeOpenPct, feeClosePct)- 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 }. Required: side, entryPrice, size, deltasPct.
workflow.run_session_structure(venue, candles, timeframe, instrument, prev_candles, session_date, value_area_rule)- Market Profile day-type classifier — trend / balance / neutral_trend / normal / normal_var, from TPO, initial balance, range extension and value migration. Use for "is this a trend day or a balance day?". Required: instrument, venue, session_date.
workflow.run_value_migration(venue, candles, timeframe, instrument, prev_candles, session_date, value_area_rule, lookback_sessions)- Market Profile value-area migration across sessions — is value migrating up, down, or overlapping (directional conviction vs balance)? Use for "is value moving higher day over day?". Required: instrument, venue, session_date.
Last successful function declaration observed on . Source: https://tradingcalc.io/api/mcp. We list what the server declared; we do not call any of these functions.
Endpoint status observed on . Source: https://tradingcalc.io/api/mcp.
Signals
These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.
| Signal | Value | What it measures | Window | Observed | Source |
|---|---|---|---|---|---|
| Latest published version | 1.5.2 | Latest version string the maintainer published to the registry. | as of fetch | Model Context Protocol | |
| Registry record last updated | 2026-04-08 | When the registry record was last updated by its maintainer. | point in time | Model Context Protocol | |
| First listed in the MCP Registry | 2026-04-08 | Date this server was first published to the official MCP Registry. Not a usage or quality measure. | point in time | Model Context Protocol | |
| mcp tools declared | 23 tools | Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. | as of probe | tradingcalc.io | |
| mcp endpoint status | ok | The server listed 23 functions when asked. | as of probe | tradingcalc.io |
Where to get it
This record as data
Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.
GET /api/v1/entries/mcp_server.json