Free crypto-futures paper trading and live market data for AI agents. 29 tools; no key for data.
Connect Remote server
claude mcp add --transport http sdk https://marginpad.io/mcp --header "X-API-Key: <X_API_KEY>"
{
"mcpServers": {
"sdk": {
"url": "https://marginpad.io/mcp",
"headers": {
"X-API-Key": "<X_API_KEY>"
}
}
}
}
{
"servers": {
"sdk": {
"type": "http",
"url": "https://marginpad.io/mcp",
"headers": {
"X-API-Key": "<X_API_KEY>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://marginpad.io/mcp
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 31 found in our last check
get_priceLive price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.
get_klinesOHLC candles for a symbol. Use this to compute indicators or check a setup before trading.
get_marketsEvery tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.
get_screenerScored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.
get_fundingCurrent funding rates across exchanges - who pays whom to hold a perp position.
get_open_interestOpen interest per symbol - how much leveraged money is committed.
get_catalystsDated 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, t…
get_what_moved_itEvery 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…
get_liquidationsRecent real liquidation events aggregated from eight exchanges.
get_fear_greedCrypto Fear and Greed index, current value and classification.
get_economic_calendarUpcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.
calc_liquidationLiquidation price for a position: entry, leverage, side.
calc_position_sizeRisk-based position size from account balance, risk percent, entry and stop.
paper_balanceYour paper account: balance, equity, free margin, unrealized P&L. Requires an API key.
paper_positionsYour paper positions with live mark price and P&L net of fees; status "open" for just the open ones. Requires an API key.
paper_tradesClosed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.
paper_openOpen a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.
paper_closeClose a simulated position, fully or partially. Requires an API key.
paper_sltpMove the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.
paper_modify_orderChange a resting limit or stop order in place: its price, stop-loss, take-profit, margin, leverage or trailing stop. Requires an API key.
paper_feesWhich 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 th…
paper_simThe 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 p…
paper_realismHow 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 o…
paper_reportThe 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.
paper_accountsEvery 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.
paper_resetRestart 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.
paper_equityThe 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.
paper_replayBacktest 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…
paper_limit_orderPlace 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.…
paper_ordersYour resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.
paper_cancel_orderCancel a resting limit order. Requires an API key.
Headers
| Name | Description |
|---|---|
X-API-KeyOptional, secret | MarginPad Bot API key (mpb_...). Optional: without it the market-data tools work, the paper-trading tools need it. |
Details
| Endpoint | https://marginpad.io/mcp (Streamable HTTP) |
| First published | 25 Oct 2026 |
| Last updated | 25 Oct 2026 |
| Registry name | io.github.Marginpad/sdk |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
