Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "sdk": {
      "type": "http",
      "url": "https://marginpad.io/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

claude mcp add --transport http sdk https://marginpad.io/mcp --header "X-API-Key: ${X_API_KEY}"

[mcp_servers.sdk]
url = "https://marginpad.io/mcp"
env_http_headers = { "X-API-Key" = "X_API_KEY" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sdk": {
      "type": "remote",
      "url": "https://marginpad.io/mcp",
      "enabled": true,
      "headers": {
        "X-API-Key": "{env:X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "sdk": {
      "type": "http",
      "url": "https://marginpad.io/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=sdk&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWFyZ2lucGFkLmlvL21jcCIsImhlYWRlcnMiOnsiWC1BUEktS2V5IjoiJHtYX0FQSV9LRVl9In19"
}

{
  "servers": {
    "sdk": {
      "type": "http",
      "url": "https://marginpad.io/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "sdk": {
      "httpUrl": "https://marginpad.io/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

extensions:
  "sdk":
    enabled: true
    name: "sdk"
    type: streamable_http
    uri: "https://marginpad.io/mcp"
    headers:
      "X-API-Key": "${X_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_API_KEY}. The registry never accepts secret values.

Quality 83 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene93 · weight 30

pass
tools.descriptionsevery tool has a description
warn
tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations29 of 29 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 4,331 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability75 · weight 15

warn
stability.changes30 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

29 tools, about 4,331 tokens to load them all · tool set 73a2efc65efc · tools last changed 2026-10-17 · checked 2026-10-20 09:31 UTC

Tool changes

2026-10-17paper_cancel_orderchangedtitle, annotations
2026-10-17paper_orderschangedtitle, annotations
2026-10-17paper_limit_orderchangedtitle, annotations
2026-10-17paper_replaychangedtitle, annotations
2026-10-17paper_equitychangedtitle, annotations
2026-10-17paper_resetchangedtitle, annotations
2026-10-17paper_accountschangedtitle, annotations
2026-10-17paper_reportchangedtitle, annotations
2026-10-17paper_realismchangedtitle, annotations
2026-10-17paper_simchangedtitle, annotations

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 97 / 100

provenance90

liveness100

freshness100

hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-100% +updated-10d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://marginpad.io/mcp` streamable-http	none	yes	100%	346 ms	2025-11-25	2026-10-20

Tools (29)

`calc_liquidation`read-only	Liquidation price for a position: entry, leverage, side.
`calc_position_size`read-only	Risk-based position size from account balance, risk percent, entry and stop.
`get_economic_calendar`read-only	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`read-only	Crypto Fear and Greed index, current value and classification.
`get_funding`read-only	Current funding rates across exchanges - who pays whom to hold a perp position.
`get_klines`read-only	OHLC candles for a symbol. Use this to compute indicators or check a setup before trading.
`get_liquidations`read-only	Recent real liquidation events aggregated from eight exchanges.
`get_markets`read-only	Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade.
`get_open_interest`read-only	Open interest per symbol - how much leveraged money is committed.
`get_price`read-only	Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed.
`get_screener`read-only	Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest.
`paper_accounts`read-only	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`read-only	Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key.
`paper_cancel_order`destructive	Cancel a resting limit order. Requires an API key.
`paper_close`destructive	Close a simulated position, fully or partially. Requires an API key.
`paper_equity`read-only	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`	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.
`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. 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_open`	Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key.
`paper_orders`read-only	Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key.
`paper_positions`read-only	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`	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.
`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 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.
`paper_report`read-only	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`destructive	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`	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.
`paper_sltp`	Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key.
`paper_trades`read-only	Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.Marginpad/sdk",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
  "remotes": [
    {
      "url": "https://marginpad.io/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "X-API-Key",
          "isSecret": true,
          "description": "MarginPad Bot API key (mpb_...). Optional: without it the market-data tools work, the paper-trading tools need it."
        }
      ]
    }
  ],
  "version": "3.0.0",
  "repository": {
    "url": "https://github.com/marginpad/sdk",
    "source": "github"
  },
  "websiteUrl": "https://marginpad.io/trading-api/#mcp",
  "description": "Free crypto-futures paper trading and live market data for AI agents. 29 tools; no key for data."
}