MCP.Market

Rubin Exchange MCP server

online · 100% uptime
by rubin.trade·trade.rubin/exchange·v1.0.2

Rubin: self-custody DEX for crypto perpetuals & spot - trade, read positions, orders, balances.

B79/100grade B
What users say
No reviews yet
Be the first
Safety scan
B79/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody has reviewed Rubin Exchange yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Rubin Exchange tools (33, 5 write)

write = sends, deletes, buys or posts
  • batch_cancelwrite actionFree

    Cancel multiple SHORT_TERM orders in one tx. SHORT_TERM only (chain limitation) — for stateful/mixed use cancel_all_orders.

  • cancel_all_orderswrite actionFree

    Cancel every OPEN order for the subaccount in a market (handles SHORT_TERM and LONG_TERM automatically). Returns `confirmation.remainingOpen` — orders still OPEN after the cancel (0 = all gone); if > 0, retry.

  • cancel_orderwrite actionFree

    Cancel a single order by clientId. For SHORT_TERM pass goodTilBlock; for LONG_TERM/CONDITIONAL pass goodTilTimeSeconds (the original good-til value, available from get_open_orders). Returns `confirmation` with the verified result (canceled / still_open / filled / pending): `code: 0` only means the cancel was broadcast. If `still_open`, the goodTil value likely did not match the original — retry.

  • close_all_positionsFree

    Flatten EVERY open perpetual position with reduce-only MARKET orders (one per market). Respects the operator market allowlist (disallowed markets are skipped and reported). Each close is bounded at oracle ± slippageBps mirrored by side (default 500 bps = 5%). Returns a per-market result array — for any market reporting unfilled/partially_filled, re-run with a larger slippageBps.

  • close_positionFree

    Close all or part of an open perpetual position with a reduce-only MARKET order. Reads the current position, flips the side automatically (LONG→SELL, SHORT→BUY) and sizes the close. percent defaults to 100 (full close); a partial close is floored to the market step size. The close is bounded at oracle ± slippageBps mirrored by side (closing a SHORT buys up to oracle×(1+slip), closing a LONG sells down to oracle×(1−slip); default 500 bps = 5%). Returns the verified `confirmation` outcome — if it is `unfilled` or `partially_filled`, the book was thinner than the cap: re-run with a larger slippageBps to sweep deeper. Errors NOT_FOUND if there is no open position in the market.

  • deposit_to_subaccountFree

    Deposit USDC from the account's WALLET into its trading SUBACCOUNT so it becomes collateral. Without amountUsd it moves everything above the $0.95 gas reserve (what the web app does); with amountUsd it moves exactly that much, as long as $0.95 stays in the wallet. Funds never leave the account — this is an internal transfer the trading key is allowed to make. Use it when the user has sent money to the account and the subaccount collateral is 0 or too low to trade.

  • get_balanceFree

    Get the subaccount collateral (USDC asset position) and the on-chain wallet bank balances. Collateral is what backs trading; the WALLET balance is where money sent to the account lands and is NOT collateral until deposited. `funding` summarizes it: depositableUsdc (wallet minus the $0.95 gas reserve) and a suggestedAction — deposit_to_subaccount when the wallet holds spare USDC, top_up_gas when gas is low.

  • get_block_heightFree

    Return the latest chain block height. Useful for SHORT_TERM order goodTilBlock math.

  • get_candlesFree

    Get OHLCV candles for a market at a given resolution. Useful for trend/volatility analysis.

  • get_candles_multiFree

    Get recent OHLCV candles for a market across MULTIPLE resolutions in one call — by default ALL indexer resolutions (1MIN, 5MINS, 15MINS, 30MINS, 1HOUR, 4HOURS, 1DAY) — so the agent can read the trend across timeframes at once. Returns { candles: { <resolution>: [...] } }, newest first. Lower `limit` (e.g. 20) or pass a `resolutions` subset to keep the payload small.

  • get_equityFree

    Get the subaccount summary: equity, freeCollateral, marginEnabled, open perpetual positions and asset positions.

  • get_fee_tierFree

    This account's current trading fee tier and conditions: maker/taker fee (% of notional; a negative maker fee is a rebate), the 30-day maker/taker volume it is judged on, any staking discount, the next tier and how much more 30d volume it takes, plus the full fee-tier table. Referred users start at the program's minimum fee tier (see get_referral_program).

  • get_fillsFree

    Get executed fills for the subaccount, including price, size, fee and maker/taker liquidity.

  • get_funding_statusFree

    Where the account's USDC sits: in the WALLET (bank balance — money sent to the account lands here and is NOT collateral) vs in the trading SUBACCOUNT (equity / free collateral). Returns depositableUsdc (wallet minus the $0.95 gas reserve), whether gas is low, and a suggestedAction (deposit_to_subaccount / top_up_gas / null). Call this when the user says they sent funds, when collateral reads 0, or before any funding decision.

  • get_leaderboardFree

    The trader PnL leaderboard for a time span (ONE_DAY, SEVEN_DAYS, THIRTY_DAYS, ONE_YEAR, ALL_TIME): rank, username, address, PnL (USD), ROI (%) and current equity per trader, paginated. Also returns `me` — this account's own row on that board, if it is ranked. Use `search` to find a trader by username or address. For this account's rank across ALL time spans at once, use get_my_rank.

  • get_marketFree

    Get details for one perpetual market (clobPairId, atomicResolution, quantumConversionExponent, tick/step sizes, oracle price, status).

  • get_my_rankFree

    Where THIS account ranks on the PnL leaderboard: rank, board size ("21 of 66"), PnL, ROI and equity — for one time span, or for every time span (ONE_DAY … ALL_TIME) when none is given. A null entry means the account is not ranked on that board (no qualifying activity in the window).

  • get_newsFree

    Fetch the latest headlines from the ritbit news feed (curated crypto / markets / business channels, newest first). Filter by `category` (crypto|markets|business) or explicit `channels`, and/or a free-text `query` (a ticker or keyword, matched in the post text and hashtags, e.g. BTC). Each item returns { source, url, publishedAt, tags (hashtags — where tickers appear), text }. There is NO importance field: judge impact yourself from the content (hacks, regulation, large moves, ⚠️ warnings). Use this to factor sentiment/catalysts into an assessment, or to answer "what's the latest?". Headlines are ru/en.

  • get_open_ordersFree

    Get currently active ORDERS for the subaccount, optionally filtered by market and side. Includes OPEN resting orders and UNTRIGGERED conditional orders (TP/SL accepted on-chain but not yet triggered). Returns { orders: [...] }. This does NOT include filled positions — a filled market/limit order leaves NO open order, it becomes a POSITION (see get_positions). When there are 0 orders but open positions exist, the result carries a `note` pointing you there.

  • get_orderbookFree

    Get the live orderbook (bids/asks) for a market, optionally truncated to a depth.

  • get_pnlFree

    Get historical PnL ticks for the subaccount (equity, totalPnl, netTransfers over time). Use createdOnOrAfter to bound the range.

  • get_portfolioFree

    One-call snapshot of everything the account has "open": equity & freeCollateral, every open POSITION (with notional, unrealized PnL and estimated liquidation price), every active ORDER (resting + untriggered TP/SL), and account margin risk. Use this to answer "what do I have open?" or "how am I doing?" without worrying whether the user means orders or positions — it returns both.

  • get_position_riskFree

    Margin health for the subaccount: equity, freeCollateral, total maintenance/initial margin, maintenanceMarginBufferUsd (the EXACT liquidation guard — liquidatable when < 0), marginUsageRatio (1.0 = at liquidation), account leverage, and per-position estimated liquidation price + distance to it. Use before adding risk or to decide whether to protect/close a position.

  • get_positionsFree

    Get perpetual POSITIONS with size, side, entryPrice, unrealizedPnl, realizedPnl and netFunding. Defaults to OPEN positions. NOTE: a position is what you HOLD after an order fills — it is NOT an open order. When the user asks loosely "what is open?", check BOTH this and get_open_orders (or call get_portfolio for both at once).

  • get_referral_programFree

    This account's referral / affiliate program status: referral code and link, whether the link is unlocked (lifetime volume threshold, or already an affiliate), current affiliate tier and taker-fee share, referred volume (30d / all-time), earnings and referred-user stats, who referred this account, the full affiliate tier table and the program parameters (referee starting fee tier, 30d caps).

  • list_marketsFree

    List all perpetual markets with ticker, status and oracle price. Use this first to discover valid market tickers (e.g. BTC-USD) before placing orders.

  • open_positionFree

    Enter a NEW position with a MARKET order, sized by base `size` OR quote `notionalUsd` (exactly one required; notionalUsd converts at the oracle price and is floored to the step size). Optionally attach a reduce-only stopLossPrice and/or takeProfitPrice as conditional orders in the SAME call (the bracket, placed with the opposite/closing side and a 500 bps execution bound past the trigger). slippageBps caps the entry fill vs oracle (default 500). Returns the entry `confirmation` plus any bracket order ids. Bracket legs are placed only if the entry broadcast succeeds; each is reduce-only so it can only close, never flip.

  • place_limit_orderwrite actionFree

    Place a limit order. Default timeInForce=GTT (long-term, durable, broadcast-commit so errors return synchronously). Use SHORT_TERM only for latency-sensitive orders (expire within ~20 blocks, broadcast async). NOTE: stateful (GTT) orders are rate-limited to 2/block and 20 per 100 blocks — pace placements. Returns `confirmation` with the REAL outcome verified via the indexer (filled / partially_filled / resting / unfilled / pending) — broadcast `code: 0` only means the tx was accepted, NOT that it filled. Report from `confirmation.outcome`; if it is `pending`, the indexer is lagging — re-check shortly.

  • place_market_orderwrite actionFree

    Place an IOC market order. It executes as an IOC limit at a worst-acceptable price mirrored around the oracle by side — BUY caps ABOVE the oracle, SELL below — at slippageBps distance (default 500 = 5%). Fills happen at book prices; the cap only limits how deep the sweep goes. reduceOnly closes an existing position. Returns `confirmation` with the REAL outcome verified via the indexer (filled / partially_filled / unfilled / pending): broadcast `code: 0` only means the tx was accepted — an IOC order cancels UNFILLED when the book is entirely beyond the slippage cap (thin/spread market). Always report from `confirmation.outcome`, not `code`; if `unfilled` or `partially_filled`, retry with a larger slippageBps to sweep deeper; if `pending`, the indexer is lagging — wait a few seconds and re-check before concluding.

  • place_stop_lossFree

    Place a reduce-only Stop loss (conditional market order) that triggers at triggerPrice. Side must be the CLOSING side of the position: SELL closes a LONG, BUY closes a SHORT. Once triggered it executes as an IOC limit bounded at triggerPrice ± slippageBps in the direction of execution (BUY above the trigger, SELL below; default 500 bps) so the close can cross the book.

  • place_take_profitFree

    Place a reduce-only Take profit (conditional market order) that triggers at triggerPrice. Side must be the CLOSING side of the position: SELL closes a LONG, BUY closes a SHORT. Once triggered it executes as an IOC limit bounded at triggerPrice ± slippageBps in the direction of execution (BUY above the trigger, SELL below; default 500 bps) so the close can cross the book.

  • top_up_gasFree

    Move a little USDC from the trading subaccount back to the WALLET when the wallet is at or below $0.55 — just enough to restore the $0.95 gas reserve that deposit/withdraw transactions need. Only the gas reserve, only to the account's own wallet; it cannot send funds anywhere else. Use after a transaction fails for lack of gas.

  • whoamiFree

    Report what this session controls: the master account (its address in BOTH forms — cosmos rit1… and EVM 0x…, the same 20 bytes), the subaccount, whether it can trade or is read-only, and the exact on-chain authorization scope (which messages, which subaccount, and that it CANNOT withdraw/transfer). Also states what this session can NOT do: create wallets, reveal keys/mnemonics, or switch accounts. Call this first, and use it to answer "what is my address?".

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 1951ms20/20
  • Tool poisoning33 tool descriptions checked15/15
  • Auth qualityAPI key sent as a header8/15
  • Maintenancelast push 105 days ago8/15
  • Maintainer identityendpoint served from the registry-verified namespace domain8/10
Overall 79/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Rubin Exchange compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
79/100
higher than 68% of 2,174 E-commerce servers
Tools
33
the typical E-commerce server has 6
Tools that change things
15%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote E-commerce server answers 100%
Response time
454 ms
faster than 35% of 1,527 E-commerce servers

What its tools let an agent do: 25 read · 1 create · 5 change · 2 delete

Install Rubin Exchange in Claude Code, Cursor or VS Code

claude mcp add --transport http exchange https://mcp.mainnet.rubin.trade/mcp
Add to Cursor

What the publisher says

From the Rubin Exchange repository's README, as published. We do not edit it. Read it on GitHub

Rubin MCP server (mainnet)

Trade crypto perpetual futures and spot on Rubin — a self-custody decentralized exchange — directly from AI agents and assistants via the Model Context Protocol (MCP).

Rubin runs a hosted, remote MCP server (streamable-HTTP). Connect any MCP client (Claude, Cursor, VS Code, etc.) and let agents place and manage orders and read live market and account data. You keep custody of your funds — trading is authorized by a scoped token you mint yourself.

  • Exchange / app: https://rubin.trade
  • MCP & AI-trading docs: https://code.rubin.trade/ai
  • Endpoint (mainnet): https://mcp.mainnet.rubin.trade/mcp · transport streamable-http
  • Official MCP Registry: trade.rubin/exchange

Tools

  • Market data — list markets, order book, candles, market stats, block height
  • Account — balances, equity, positions, open orders, fills, PnL
  • Trading — place / cancel limit & market orders, stop-loss, take-profit, cancel-all, batch-cancel

Authentication

Send an Authorization: Bearer header. Mint a free MCP token on the Rubin exchange:

https://rubin.trade → Trading Keys → MCP Token

Connect

Claude Code / CLI

claude mcp add --transport http rubin https://mcp.mainnet.rubin.trade/mcp \
  --header "Authorization: Bearer <YOUR_MCP_TOKEN>"

Generic mcp.json (Claude Desktop / Cursor / others)

{
  "mcpServers": {
    "rubin": {
      "type": "streamable-http",
      "url": "https://mcp.mainnet.rubin.trade/mcp",
      "headers": { "Authorization": "Bearer <YOUR_MCP_TOKEN>" }
    }
  }
}

VS Code (GitHub Copilot) — .vscode/mcp.json

{
  "servers": {
    "rubin": {
      "type": "http",
      "url": "https://mcp.mainnet.rubin.trade/mcp",
      "headers": { "Authorization": "Bearer <YOUR_MCP_TOKEN>" }
    }
  }
}

See code.rubin.trade/ai for ready-made snippets for every client.

Manifest

server.json — the MCP Registry manifest for this server.

Links

  • Exchange: https://rubin.trade
  • Builder & MCP docs: https://code.rubin.trade
  • Market data API (indexer): https://indexer.mainnet.rubin.trade

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Rubin Exchange: common questions

Is Rubin Exchange MCP server safe?
Mostly: it is graded B (79/100). Read the Rubin Exchange safety report
How do I install Rubin Exchange?
It runs remotely at mcp.mainnet.rubin.trade. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Rubin Exchange need an API key?
Yes. The registry entry asks for Authorization.
Is Rubin Exchange maintained?
The last commit was 126 days ago (2026-07-01). The latest release is v1.0.2.
Is Rubin Exchange up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Rubin Exchange?
Servers from other publishers that do the same job: Iran Crypto Exchanges MCP server, Acedatacloud MCP server and Robinhood Crypto MCP server.
How does Rubin Exchange compare with other E-commerce MCP servers?
safety score 79/100 (higher than 68% of 2,174 E-commerce servers); tools 33 (the typical E-commerce server has 6); tools that change things 15% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Rubin Exchange

Same job from other publishers: the closest match first, then the best rated.

  • Iran Crypto Exchanges
    Unofficial read-only Iranian crypto exchanges: prices in Toman, order books, trades, candles.
    A
  • Acedatacloud
    Manage your AceData Cloud account: services, pricing, APIs, docs, balance, usage, keys & orders
    A
  • Robinhood Crypto
    Robinhood Crypto Trading API for AI agents: quotes, holdings, orders read-only; opt-in trading.
    B
  • Omie
    MCP server for Omie — ERP, customers, products, orders, invoices, financials
    B
  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B