MCP server

Marginpad Sdk Official

io.github.Marginpad/sdk

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Working at last checkOfficial: marginpad.io's GitHub account (Marginpad)About 4,358 tokens per request once connected29 tools

Website Source

https://marginpad.io/mcp

At a glance

Type: MCP server
Publisher: marginpad.io (verified by the MCP Registry)
Status: Working at last check
Tools: 29
Token cost: About 4,358 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.sdk]
url = "https://marginpad.io/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"sdk":{"type":"http","url":"https://marginpad.io/mcp"}}}

Antigravity

agy mcp add sdk https://marginpad.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"sdk","server_url":"https://marginpad.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"sdk","server_url":"https://marginpad.io/mcp"}

Tools

calc_liquidation ~84 tokens
Liquidation price for a position: entry, leverage, side.
calc_position_size ~94 tokens
Risk-based position size from account balance, risk percent, entry and stop.
get_economic_calendar ~70 tokens
Upcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory.
get_fear_greed ~44 tokens
Crypto Fear and Greed index, current value and classification.
get_funding ~56 tokens
Current funding rates across exchanges - who pays whom to hold a perp position.
get_klines ~93 tokens
OHLC candles for a symbol. Use this to compute indicators or check a setup before trading.
get_liquidations ~52 tokens
Recent real liquidation events aggregated from eight exchanges.
get_markets ~80 tokens
Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.
get_open_interest ~53 tokens
Open interest per symbol - how much leveraged money is committed.
get_price ~90 tokens
Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.
get_screener ~55 tokens
Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.
paper_accounts ~86 tokens
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_balance ~51 tokens
Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key.
paper_cancel_order ~57 tokens
Cancel a resting limit order. Requires an API key.
paper_close ~83 tokens
Close a simulated position, fully or partially. Requires an API key.
paper_equity ~111 tokens
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_fees ~160 tokens
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_limit_order ~243 tokens
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_modify_order ~137 tokens
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_open ~288 tokens
Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.
paper_orders ~56 tokens
Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.
paper_positions ~85 tokens
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_realism ~371 tokens
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_replay ~280 tokens
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_report ~111 tokens
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_reset ~89 tokens
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_sim ~1173 tokens
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_sltp ~120 tokens
Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.
paper_trades ~86 tokens
Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.

Browse

Related MCP servers

CoinRithm Agent Trading
Keyless prediction-market data across 12 venues plus paper-trading of crypto spot, futures, and PM.
TradeAssi
Crypto tools for AI agents: live market data, exchange-wide screener, backtests and paper trading.
Agent Arena
Paper trading only. 26 leagues for AI bots. Spot Crypto + Crypto 35 live. Register by MCP.
Tensorust
Receipts-first data: real crates.io downloads, dated LLM API prices, sourced answers, free dev tools
HYPERneobroker.com
Live prices, perps, prediction markets and a paper trading desk over one MCP.
BotSpot: AI Trading, Backtests and Bots
AI agents backtest, paper trade and live trade via your broker. Free to connect; OAuth.
AlgoVault — Crypto Quant Trade Calls
The Brain Layer for AI Trading Agents — quant calls + cross-venue arb across perp venues via MCP.
Newsgurus Intel
Pay-per-call trading intelligence for AI agents: live market regime, trading signals, composite conv

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.Marginpad/sdk.svg)](https://aptlynx.net/servers/io.github.Marginpad/sdk)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents