Skip to main content
Glama
xRocket Exchange MCP

xRocket Exchange MCP

xRocket Exchange MCP

Set one daily value limit and let an MCP-capable AI agent place and cancel xRocket spot orders autonomously inside it. Transfers and withdrawals remain separate explicit-approval operations.

The hosted endpoint remains a public market-data demo and onboarding path; it never receives account credentials and cannot trade. This package is not affiliated with or endorsed by xRocket. Set up trading or open xRocket.

Trading quick start

  1. Sign in to xRocket and open Menu → Settings → Exchange settings → API token.

  2. Generate a testnet-first MCP configuration with a daily limit:

    npx -y xrocket-mcp@0.6.0 trading-config --limit 100 --asset USD
  3. Paste the printed JSON into your local MCP client. Replace SET_YOUR_XROCKET_API_TOKEN_LOCALLY only in the client's local secret or environment settings.

  4. Give the client a strategy. It can place and cancel market or limit orders on any available spot pair until the configured daily value or built-in order-count limits are reached.

Use npx -y xrocket-mcp@0.6.0 trading-config --limit 100 --asset USD --mainnet only after testnet validation. Transfers and withdrawals stay disabled.

The upstream token has broad account access rather than documented granular scopes. Never put it in chat, the hosted endpoint, a committed file, an issue, or a log.

Related MCP server: @getplexa/mcp

Hosted market demo

Use the connection page or copy the public mainnet endpoint without installing anything or supplying credentials:

https://xrocket-mcp-production.up.railway.app/mcp

It exposes only the 10 public tools and cannot read account tokens or enable financial writes. When asked to trade, its onboarding tool points the user to the local setup above.

Local quick start

npx -y xrocket-mcp@0.6.0 doctor
npx -y xrocket-mcp@0.6.0 config

Node.js 20 or newer is required. Public market reads work without configuration:

XROCKET_PROFILE=public
XROCKET_ENVIRONMENT=mainnet

Install the all-in-one Codex plugin from the repository marketplace:

codex plugin marketplace add nakazanie-ton/myrocket --ref main
codex plugin add xrocket-exchange@xrocket-agents

GitHub Copilot CLI can install the portable plugin directly:

copilot plugin install nakazanie-ton/myrocket:plugins/xrocket-exchange

The portable install connects only to the hosted public market tools. Use the trading quick start above when local account access is needed.

Gemini CLI:

gemini extensions install https://github.com/nakazanie-ton/myrocket

The root Gemini extension uses the same hosted public-only endpoint and local trading handoff.

Claude Code:

claude plugin marketplace add nakazanie-ton/myrocket
claude plugin install xrocket-exchange@xrocket-agents

Both marketplace plugins start with public market tools. The bundled skill handles the sign-in and one-limit local trading setup when private access is needed.

MCP client example:

{
  "mcpServers": {
    "xrocket": {
      "command": "npx",
      "args": ["-y", "xrocket-mcp@0.6.0"],
      "env": {
        "XROCKET_ENVIRONMENT": "mainnet",
        "XROCKET_ENABLE_TRADING": "false",
        "XROCKET_ENABLE_TRANSFERS": "false",
        "XROCKET_ENABLE_WITHDRAWALS": "false",
        "XROCKET_ALLOW_MAINNET_WRITES": "false"
      }
    }
  }
}

For source development, run npm ci, npm test, and npm run build in this directory.

Profiles and write gates

  • public: 10 unauthenticated tools, including the composed xrocket_market_snapshot.

  • private-read: public tools plus balances, whole-account overview, orders, transfers, withdrawals, and quotas; inferred when XROCKET_API_TOKEN is present.

  • full: all tools, including autonomous trading plus explicit transfer/withdrawal workflows; every capability remains disabled unless its own gate is true.

Write gates are XROCKET_ENABLE_TRADING, XROCKET_ENABLE_TRANSFERS, and XROCKET_ENABLE_WITHDRAWALS; all default to false. Mainnet writes also require XROCKET_ALLOW_MAINNET_WRITES=true.

xrocket_agent_trade estimates and values each order before submitting it once. The local durable ledger enforces the configured daily value limit across restarts, while today's xrmcp-… exchange history recovers usage created by another local process. Daily order-count and active-order guards remain built in. All spot symbols are allowed by default; an optional symbol allowlist is available for advanced setups. Ambiguous order outcomes stay reserved against the limit and are not retried.

Transfers and withdrawals still store an exact prepared intent and accept only its short-lived, single-use approval receipt. The normal trading config keeps both gates disabled.

Boundaries

  • The Exchange API has no deposit-address endpoint; onboarding is a UI guide only.

  • Exchange transfers are internal funding ↔ trading, not user-to-user payments.

  • xRocket Pay is a separate product and is not included.

  • WebSocket channels are audited but 0.6.0 uses bounded REST snapshots.

  • Keep financial values as decimal strings and use TONCOIN where the current API requires it.

Full documentation, coverage, security policy, privacy notice, and terms live in the project repository.

Available Tools

10 tools
xrocket_asset_infoxRocket assetsB
Read-onlyIdempotent
Inspect

List public assets or inspect one exact asset identifier.

Inputs: asset. Returns: result

xrocket_market_candlesxRocket candlesA
Read-onlyIdempotent
Inspect

Get public OHLCV candles for an exact ISO-8601 time window.

Inputs: type (required), endAt (required), symbol (required), startAt (required). Returns: result

xrocket_market_orderbookxRocket order bookB
Read-onlyIdempotent
Inspect

Get a public order-book snapshot. Precision must be valid for the selected pair.

Inputs: symbol (required), depth, precision. Returns: result

xrocket_market_snapshotxRocket market snapshotA
Read-onlyIdempotent
Inspect

Resolve an exact symbol or base asset and return market rules, ticker, best bid/ask, recent trades, and fees in one read-only call. Exact symbols win; ambiguous assets are never guessed.

Inputs: market (required), depth, precision. Returns: result

xrocket_market_symbolsxRocket symbolsA
Read-onlyIdempotent
Inspect

List all exchange symbols or inspect one exact symbol and its trading constraints.

Inputs: symbol. Returns: result

xrocket_market_tickersxRocket 24h tickersB
Read-onlyIdempotent
Inspect

Get public 24-hour ticker data, optionally for a repeated list of symbols.

Inputs: symbols. Returns: result

xrocket_market_tradesxRocket recent tradesA
Read-onlyIdempotent
Inspect

Get recent public trades for one symbol.

Inputs: symbol (required). Returns: result

xrocket_ratesxRocket ratesB
Read-onlyIdempotent
Inspect

Get public crypto-asset rates in one fiat base currency.

Inputs: base (required), assets. Returns: result

xrocket_trade_feesxRocket trade feesA
Read-onlyIdempotent
Inspect

Get exchange trade-fee data, optionally for repeated symbols.

Inputs: symbols. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation3/5

    Most tools target distinct resources: symbols, tickers, candles, orderbook, trades, assets, fees, rates, and onboarding. The notable exception is xrocket_market_snapshot, which intentionally combines ticker/trades/fees/orderbook data into one call and creates selection ambiguity with the granular market tools.

    Naming Consistency5/5

    All tool names share the xrocket_ prefix and follow a consistent lowercase_snake_case resource pattern. The repeated xrocket_market_* grouping makes the public-market tools easily predictable, and the few non-market tools still follow the same naming convention.

    Tool Count5/5

    With 10 tools, the set is well-scoped for a public market-data and onboarding server. Each tool appears to earn its place, and the count is neither bloated nor too thin.

    Completeness4/5

    The surface fully covers a public exchange market-data workflow: symbols, tickers, candles, orderbook, trades, assets, rates, fees, and startup onboarding links. Private account and order-management tools are missing, but those appear out of scope for this read-only data and integration-link server.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      Safe-by-default MCP server for the official Toss Securities Open API, providing read-only market and account data with optional order operations protected by multiple safety gates.
      27
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A Model Context Protocol server that gives any MCP client two economic-safety tools: realizable quote and pretrade check, paid per call in USDC with no accounts.
      2
      93 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server providing x402-paid tools for tokenized stock data on EVM chains, including premium/discount, liquidity, whale activity, and a guarded trading wrapper for Robinhood Chain.
      1
      MIT