All servers · Research & knowledge · Markets & trading

io.github.Marginpad/sdk

io.github.Marginpad/sdk · v3.0.0

Measured by MCP Station

Description written by the publisher, not verified

Free crypto-futures paper trading and live market data for AI agents. 29 tools; no key for data.

Connect

claude mcp add --transport http sdk https://marginpad.io/mcp

{
  "mcpServers": {
    "sdk": {
      "url": "https://marginpad.io/mcp"
    }
  }
}

Tools as reported by the server

• get_price
  Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.
• get_klines
  OHLC candles for a symbol. Use this to compute indicators or check a setup before trading.
• get_markets
  Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.
• get_screener
  Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.
• get_funding
  Current funding rates across exchanges - who pays whom to hold a perp position.
• get_open_interest
  Open interest per symbol - how much leveraged money is committed.
• get_liquidations
  Recent real liquidation events aggregated from eight exchanges.
• get_fear_greed
  Crypto Fear and Greed index, current value and classification.
• get_economic_calendar
  Upcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.
• calc_liquidation
  Liquidation price for a position: entry, leverage, side.
• calc_position_size
  Risk-based position size from account balance, risk percent, entry and stop.
• paper_balance
  Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key.
• paper_positions
  Your paper positions with live mark price and P&L net of fees; status "open" for just the open ones. Requires an API key.
• paper_trades
  Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.
• paper_open
  Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.
• paper_close write/delete
  Close a simulated position, fully or partially. Requires an API key.
• paper_sltp
  Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.
• paper_modify_order
  Change a resting limit or stop order in place: its price, stop-loss, take-profit, margin, leverage or trailing stop. Requires an API key.
• paper_fees
  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 ke
• paper_sim
  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
• paper_realism
  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 t
• paper_report
  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.
• paper_accounts
  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.
• paper_reset write/delete
  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.
• paper_equity
  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.
• paper_replay
  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
• paper_limit_order
  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
• paper_orders
  Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.
• paper_cancel_order write/delete
  Cancel a resting limit order. Requires an API key.

Tool changes

• 2026-10-17: get_price, get_klines, get_markets, get_screener, get_funding, get_open_interest, get_liquidations, get_fear_greed, get_economic_calendar, calc_liquidation, calc_position_size, paper_balance
• 2026-10-16: get_price, get_klines, get_markets, get_screener, get_funding, get_open_interest, get_liquidations, get_fear_greed, get_economic_calendar, calc_liquidation, calc_position_size, paper_balance

Repository · Website · JSON · Text for agents · Registry updated 2026-10-10