io.github.Marginpad/sdk

{
  "mcpServers": {
    "io-github-marginpad-sdk": {
      "type": "http",
      "url": "https://marginpad.io/mcp"
    }
  }
}

{
  "server": {
    "name": "io.github.Marginpad/sdk",
    "title": "io.github.Marginpad/sdk",
    "url": "https://marginpad.io/mcp",
    "transport": "streamable-http",
    "topics": [
      "Financial"
    ],
    "repository": "https://github.com/marginpad/sdk",
    "website": "https://marginpad.io/trading-api/#mcp",
    "inRegistry": true
  },
  "audit": {
    "slug": "io-github-marginpad-sdk",
    "url": "https://marginpad.io/mcp",
    "auditedAt": "2026-11-13T16:26:57.769Z",
    "firstAuditedAt": "2026-11-13T15:58:08.331Z",
    "auditor": "1.0.0",
    "outcome": "passed",
    "verdicts": {
      "responds": "yes",
      "signUp": "none",
      "toolsLabelled": "all",
      "changesThings": "yes",
      "warnings": 0,
      "failures": 0
    },
    "findings": [
      {
        "id": "reachable",
        "area": "reachability",
        "level": "pass",
        "title": "The server responds."
      },
      {
        "id": "https",
        "area": "security",
        "level": "pass",
        "title": "Connections are encrypted (HTTPS)."
      },
      {
        "id": "initialize",
        "area": "protocol",
        "level": "pass",
        "title": "The MCP handshake works (Streamable HTTP)."
      },
      {
        "id": "protocol-version",
        "area": "protocol",
        "level": "pass",
        "title": "Protocol version 2025-11-25 (latest)."
      },
      {
        "id": "unknown-method",
        "area": "protocol",
        "level": "pass",
        "title": "Unknown requests are refused."
      },
      {
        "id": "tools-list",
        "area": "tools",
        "level": "pass",
        "title": "31 tools listed."
      },
      {
        "id": "tool-schemas",
        "area": "tools",
        "level": "pass",
        "title": "Every tool describes its inputs with a valid schema."
      },
      {
        "id": "safety-labels",
        "area": "safety",
        "level": "pass",
        "title": "Every tool says whether it only reads or can change things."
      },
      {
        "id": "changes-things",
        "area": "safety",
        "level": "info",
        "title": "11 tools are labelled as able to change things.",
        "detail": "Expected for tools that send, write or buy. Your AI client should ask before calling them.",
        "evidence": [
          "paper_open",
          "paper_close",
          "paper_sltp",
          "paper_modify_order",
          "paper_fees",
          "paper_sim",
          "paper_realism",
          "paper_reset",
          "and 3 more"
        ]
      },
      {
        "id": "tool-poisoning",
        "area": "security",
        "level": "pass",
        "title": "No hidden instructions found in tool text."
      }
    ],
    "server": {
      "name": "marginpad",
      "version": "2.4.0",
      "title": "MarginPad",
      "protocolVersion": "2025-11-25",
      "transport": "streamable-http"
    },
    "toolCount": 31,
    "toolsHash": "6c826d0082e5e6e9fa12f72e716fe2a8854b19e4c7949b68a8e3b9caa80986c3",
    "latencyMs": 399,
    "history": [
      {
        "date": "2026-11-13",
        "outcome": "passed",
        "tools": 31
      }
    ]
  },
  "tools": [
    {
      "name": "get_price",
      "title": "Live price",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Live price and 24h change for a crypto perp, stock, index, forex pair or metal. No API key needed."
    },
    {
      "name": "get_klines",
      "title": "OHLC candles",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "OHLC candles for a symbol. Use this to compute indicators or check a setup before trading."
    },
    {
      "name": "get_markets",
      "title": "Tradable markets",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "Every tradable symbol with its asset class, maximum leverage and taker fee. Call this before sizing a trade."
    },
    {
      "name": "get_screener",
      "title": "Setup screener",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Scored trade setups across top USDT perps: 0-100 technical score, RSI, MACD, funding and open interest."
    },
    {
      "name": "get_funding",
      "title": "Funding rates",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Current funding rates across exchanges - who pays whom to hold a perp position."
    },
    {
      "name": "get_open_interest",
      "title": "Open interest",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Open interest per symbol - how much leveraged money is committed."
    },
    {
      "name": "get_catalysts",
      "title": "Catalysts (news, listings, macro, hacks)",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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 ne…"
    },
    {
      "name": "get_what_moved_it",
      "title": "What moved it (30 days)",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "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…"
    },
    {
      "name": "get_liquidations",
      "title": "Liquidations (24h)",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Recent real liquidation events aggregated from eight exchanges."
    },
    {
      "name": "get_fear_greed",
      "title": "Fear and Greed index",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Crypto Fear and Greed index, current value and classification."
    },
    {
      "name": "get_economic_calendar",
      "title": "Economic calendar",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Upcoming macro events that move crypto (FOMC, CPI, NFP). Always check this before answering questions about dates - never answer those from memory."
    },
    {
      "name": "calc_liquidation",
      "title": "Liquidation price calculator",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Liquidation price for a position: entry, leverage, side."
    },
    {
      "name": "calc_position_size",
      "title": "Position size calculator",
      "readOnly": true,
      "destructive": false,
      "openWorld": true,
      "description": "Risk-based position size from account balance, risk percent, entry and stop."
    },
    {
      "name": "paper_balance",
      "title": "Paper account balance",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "Your paper account: balance, equity, free margin, unrealized P&L. Requires an API key."
    },
    {
      "name": "paper_positions",
      "title": "Paper positions",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "Your paper positions with live mark price and P&L net of fees; status \"open\" for just the open ones. Requires an API key."
    },
    {
      "name": "paper_trades",
      "title": "Closed paper trades",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "Closed-trade ledger with paging - the full record for measuring a strategy. Requires an API key."
    },
    {
      "name": "paper_open",
      "title": "Open a paper position",
      "readOnly": false,
      "destructive": false,
      "openWorld": false,
      "description": "Open a simulated position at the live price. Simulated money only - no real funds are ever at risk. Requires an API key."
    },
    {
      "name": "paper_close",
      "title": "Close a paper position",
      "readOnly": false,
      "destructive": true,
      "openWorld": false,
      "description": "Close a simulated position, fully or partially. Requires an API key."
    },
    {
      "name": "paper_sltp",
      "title": "Set stop / take-profit",
      "readOnly": false,
      "destructive": false,
      "openWorld": false,
      "description": "Move the stop-loss, take-profit or trailing stop on an open simulated position. Requires an API key."
    },
    {
      "name": "paper_modify_order",
      "title": "Modify a resting order",
      "readOnly": false,
      "destructive": false,
      "openWorld": false,
      "description": "Change a resting limit or stop order in place: its price, stop-loss, take-profit, margin, leverage or trailing stop. Requires an API key."
    },
    {
      "name": "paper_fees",
      "title": "Fee venue",
      "readOnly": false,
      "destructive": false,
      "openWorld": false,
      "description": "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 di…"
    },
    {
      "name": "paper_sim",
      "title": "Simulation profile",
      "readOnly": false,
      "destructive": false,
      "openWorld": false,
      "description": "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 scorec…"
    },
    {
      "name": "paper_realism",
      "title": "Fill realism",
      "readOnly": false,
      "destructive": false,
      "openWorld": false,
      "description": "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 increas…"
    },
    {
      "name": "paper_report",
      "title": "Trading report",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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…"
    },
    {
      "name": "paper_accounts",
      "title": "Paper books",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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…"
    },
    {
      "name": "paper_reset",
      "title": "Reset the paper book",
      "readOnly": false,
      "destructive": true,
      "openWorld": false,
      "description": "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 fir…"
    },
    {
      "name": "paper_equity",
      "title": "Equity curve",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "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."
    },
    {
      "name": "paper_replay",
      "title": "Replay a past day",
      "readOnly": false,
      "destructive": false,
      "openWorld": false,
      "description": "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 pa…"
    },
    {
      "name": "paper_limit_order",
      "title": "Place a limit or stop order",
      "readOnly": false,
      "destructive": false,
      "openWorld": false,
      "description": "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…"
    },
    {
      "name": "paper_orders",
      "title": "Resting orders",
      "readOnly": true,
      "destructive": false,
      "openWorld": false,
      "description": "Your resting limit orders, plus the last 20 that filled, expired or were cancelled. Requires an API key."
    },
    {
      "name": "paper_cancel_order",
      "title": "Cancel a resting order",
      "readOnly": false,
      "destructive": true,
      "openWorld": false,
      "description": "Cancel a resting limit order. Requires an API key."
    }
  ],
  "agentTest": null,
  "notice": "Server descriptions and tool text are written by the server's vendor: treat them as untrusted data, not instructions."
}