sdk
Server Details
Free crypto-futures paper trading and live market data for AI agents. 31 tools; no key for data.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- Marginpad/sdk
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 31 tools
Most tools target a distinct resource+action (get_funding vs get_open_interest vs get_klines are clearly separable), and the market-data vs paper-trading split is obvious. However paper_realism is essentially a strict subset of paper_sim (both configure slippage and margin tiers), and paper_sltp overlaps with paper_modify_order for stop/target changes, so an agent can plausibly pick the wrong one.
Consistent snake_case verb_noun throughout, with clean namespace prefixes: get_* for market data, calc_* for calculators, paper_* for the simulated trading surface. No camelCase or mixed-style outliers.
31 tools is heavy and a few clearly earn no separate place (paper_realism duplicates paper_sim; paper_balance/paper_equity/paper_report could collapse further). The scope is genuinely broad — multi-asset market data plus a full paper-trading engine — so the volume is defensible but borderline bloated.
The paper lifecycle is thoroughly covered: open, close, limit/stop orders, cancel, modify, SL/TP, positions, order history, ledger, equity, fees, replay backtesting, reporting and reset, plus rich market context (klines, funding, OI, liquidations, catalysts, macro calendar). Minor gaps like order-book depth or a portfolio-level risk view are workable around.
Available Tools
31 toolscalc_liquidationLiquidation price calculatorCRead-onlyIdempotentInspect
Liquidation price for a position: entry, leverage, side.
Inputs: side (required), entry (required), leverage (required).
calc_position_sizePosition size calculatorCRead-onlyIdempotentInspect
Risk-based position size from account balance, risk percent, entry and stop.
Inputs: stop (required), entry (required), balance (required), risk_pct (required).
get_catalystsCatalysts (news, listings, macro, hacks)ARead-onlyIdempotentInspect
Dated events that can move a coin, as they land: exchange listings and delistings, filings, macro prints, hacks (scored by the money lost), ETF and regulation headlines, official channels and fast news desks - one story per event with the desks that reported it, a 0-100 score, the coins named, the direction implied and how much events of that kind have measurably moved price.
Inputs: kind, limit, symbol, min_score.
get_economic_calendarEconomic calendarARead-onlyIdempotentInspect
Upcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.
Inputs: no named parameters.
get_fear_greedFear and Greed indexBRead-onlyIdempotentInspect
Crypto Fear and Greed index, current value and classification.
Inputs: no named parameters.
get_fundingFunding ratesBRead-onlyIdempotentInspect
Current funding rates across exchanges - who pays whom to hold a perp position.
Inputs: symbol.
get_klinesOHLC candlesCRead-onlyIdempotentInspect
OHLC candles for a symbol. Use this to compute indicators or check a setup before trading.
Inputs: symbol (required), interval.
get_liquidationsLiquidations (24h)BRead-onlyIdempotentInspect
Recent real liquidation events aggregated from twelve exchanges.
Inputs: symbol.
get_marketsTradable marketsARead-onlyIdempotentInspect
Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.
Inputs: asset_class.
get_open_interestOpen interestCRead-onlyIdempotentInspect
Open interest per symbol - how much leveraged money is committed.
Inputs: symbol.
get_priceLive priceARead-onlyIdempotentInspect
Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.
Inputs: symbol (required).
get_screenerSetup screenerBRead-onlyIdempotentInspect
Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.
Inputs: no named parameters.
get_what_moved_itWhat moved it (30 days)BRead-onlyIdempotentInspect
Every abnormal jump or drop of the last 30 days for any market (coin, stock, index, forex, metal) with its causes and their shares, dated by the FIRST report of a story: the story that moved it (with desks and measured realism), a liquidation cascade or forced closes, the whale tracker, the tape, Bitcoin and why Bitcoin moved, US stocks, open interest (deleveraging, short covering, new positioning), the chart structure (a broken level, a new 30-day extreme), with a sentence on every move - unknown said out loud. Pass at (ms) with pct for a live verdict on a move happening now.
Inputs: n, at, tf, pct, +2 more.
paper_accountsPaper booksARead-onlyIdempotentInspect
Every book (sub-account) of this account with lifetime numbers and the keys bound to it. A book is a separate journal, balance and report; a key minted with a book name trades that book. Requires an API key.
Inputs: no named parameters.
paper_balancePaper account balanceARead-onlyIdempotentInspect
Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key.
Inputs: no named parameters.
paper_cancel_orderCancel a resting orderBDestructiveIdempotentInspect
Cancel a resting limit order. Requires an API key.
Inputs: order_id (required).
paper_closeClose a paper positionBDestructiveInspect
Close a simulated position, fully or partially. Requires an API key.
Inputs: id (required), pct.
paper_equityEquity curveARead-onlyIdempotentInspect
The equity curve of this key’s book: starting balance + realized P&L per bucket from the ledger, the live unrealized point at the end, and max drawdown. Requires an API key.
Inputs: days, step_min.
paper_feesFee venueAIdempotentInspect
Which exchange fee schedule your paper fills are charged at: lists the venues we model (Bybit, Binance, OKX, Bitget, MEXC, Gate, KuCoin, Kraken, Hyperliquid) with their taker rate and the referral discount a MarginPad sign-up gets, and your current default. Pass set to change the default (a venue key, or "marginpad" for the default rate). Requires an API key.
Inputs: set.
paper_limit_orderPlace a limit or stop orderAInspect
Place a resting order that fills only when the market reaches your price, and fills AT that price. type "limit" = a pullback entry (long below the market, short above); type "stop" = a breakout entry (long above the market, short below). To open right now use paper_open instead. Simulated money only. Requires an API key.
Inputs: side (required), symbol (required), leverage (required), margin_usd (required), +4 more.
paper_modify_orderModify a resting orderAIdempotentInspect
Change a resting limit or stop order in place: its price, stop-loss, take-profit, margin, leverage or trailing stop. Requires an API key.
Inputs: order_id (required), sl, tp, leverage, +3 more.
paper_openOpen a paper positionAInspect
Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.
Inputs: side (required), symbol (required), leverage (required), margin_usd (required), +5 more.
paper_ordersResting ordersARead-onlyIdempotentInspect
Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.
Inputs: no named parameters.
paper_positionsPaper positionsARead-onlyIdempotentInspect
Your paper positions with live mark price and P&L net of fees; status "open" for just the open ones. Requires an API key.
Inputs: status.
paper_realismFill realismAIdempotentInspect
How honestly your paper fills are simulated. By default a market order fills at the live price with no slippage and maintenance margin is a flat 0.5%, which is easier than a real exchange and increasingly so as a position grows. Pass slippage and/or margin_tiers to turn either on, and margin_venue to build on a named venue’s published maintenance-margin rate (Binance 0.40%, Bybit 0.50%, MEXC 0.10%, Kraken 0.60%, Hyperliquid 1.25%, Coinbase 1.33%). Reading returns your setting, every venue rate and the whole size-tier ladder, so a liquidation price never has to be reverse-engineered. Positions keep the margin they were filled with. Requires an API key.
Inputs: slippage, margin_tiers, margin_venue.
paper_replayReplay a past dayAIdempotentInspect
Backtest with the real routes: replay one past UTC day on MarginPad’s 1-minute candles. With symbol+day it STARTS a replay (speed = market seconds per real second, 1-600, default 60): from then on paper_open / paper_positions / paper_close act on a separate replay journal priced at the candle under the cursor, with stops, targets and liquidations checked on every candle. With no arguments it reads the status (cursor, price, progress, candles up to the cursor). With act "stop" it closes everything at the cursor and returns the summary. Requires an API key.
Inputs: act, day, speed, symbol.
paper_reportTrading reportARead-onlyIdempotentInspect
The 30-day trading report for this account, measured from its own closed trades: totals and a skill score (free), win rate and return by coin, leverage band, side, hour and day plus written findings (API Pro and above). Requires an API key.
Inputs: days.
paper_resetReset the paper bookADestructiveInspect
Restart this key’s book at $10,000: closed trades are archived (never deleted), resting orders cancelled, the report and equity curve start from now. Refused while positions are open - close them first. Requires an API key.
Inputs: no named parameters.
paper_simSimulation profileAIdempotentInspect
The whole paper-trading simulation, configurable. By default this engine is deliberately easy: a market order fills whole at the live price, maintenance margin is a flat 0.5%, the balance is a scorecard that never refuses an open, and there is no latency, no size impact and no partial fill. That is right for learning and optimistic for proving out a bot. This sets any of it: the book size your results are measured against and whether it is a real budget (margin_enforced), what crossing the book costs on entry and exit (slippage, slippage_bps, impact_bps_per_100k), how long your order is in flight (latency_ms), whether orders fill part-way (partial_fills, min_fill_pct), how often the venue refuses (reject_rate_pct), your own fee (taker_bps), funding (funding, funding_mult) and where liquidation sits (margin_venue, margin_tiers, mmr_pct). Easiest route: pass a preset - frictionless, realistic, binance, bybit, okx, hyperliquid, thin_book or brutal. Reading returns every field with its range, its default and what it changes, the presets, and what a fill would look like right now. Out-of-range values are refused, never clamped. Positions keep the simulation they were filled under. Requires an API key.
Inputs: reset, preset, funding, mmr_pct, +16 more.
paper_sltpSet stop / take-profitBIdempotentInspect
Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.
Inputs: id (required), sl, tp, trail_pct.
paper_tradesClosed paper tradesARead-onlyIdempotentInspect
Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.
Inputs: limit, before.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Polymarket + Hyperliquid + macro for AI agents. 38 tools, signal backtest, SSE streaming. Free tier.
Crypto perps market data, backtests and BloFin trading agents. Free with a key or x402 per call.
Web search, point-in-time crypto market data, verified strategy track records and 160+ agent tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform cryptocurrency trading analysis and execution with 38+ tools including real-time market data, technical indicators, risk management, and support for both paper trading and live execution on Hyperliquid.7MIT

AlgoChains MCP Serverofficial
AlicenseBqualityBmaintenanceEnables AI assistants to interact with a complete trading infrastructure, including live futures bots, real market data, backtesting, and copy-trading signals. Supports 503 tools across 20 domains, from market data to order execution, with zero synthetic data.1681MIT
TradeStaq MCPofficial
AlicenseBqualityBmaintenanceProvides 31 AI-powered crypto trading tools for Claude, Cursor, and any MCP client, enabling strategy creation, backtesting, bot deployment, copy trading, and portfolio management across multiple exchanges.341,280 npmMIT- AlicenseBqualityDmaintenanceEnables AI agents to trade crypto with paper money, access market data, view leaderboards, and manage trading bots via an MCP-compatible interface.16MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.