Revolut X MCP Server

Official MCP server for Revolut X, the company's crypto exchange. Exposes read-only tools for market data, balances, orders, monitoring, and grid strategy backtests.

Finance by Revolut API Key active

GitHub Docs

Overview

Revolut X is Revolut's advanced crypto exchange aimed at active traders. The official MCP server (revolut-engineering/revolut-x-api) lets Claude Desktop, Claude Code, and other MCP-compatible clients query the Revolut X REST API directly, so you can analyze markets, monitor positions, and run strategy backtests through natural language.

The server is read-only by design: it can fetch tickers, candles, order books, balances, and order history, and run technical indicators or grid strategy simulations, but it cannot place, modify, or cancel real orders. Authentication is handled locally with an Ed25519 keypair, the public key is registered in your Revolut X account, and private keys never leave your machine. The API package itself ships with zero runtime dependencies, using only Node.js built-ins.

The repo is maintained by the Revolut Engineering organization on GitHub and is MIT-licensed. It became publicly known after Revolut's Head of Product for Crypto demoed building a market-making workflow with Claude and the Revolut X API in roughly 30 minutes, using this MCP server as the connective tissue.

Tools

Tool	Description
`generate_keypair`	Generate a local Ed25519 keypair used to authenticate with the Revolut X API.
`configure_api_key`	Store the Revolut X API key returned by the exchange after registering your public key.
`check_auth_status`	Verify that the stored credentials work and report available currencies.
`get_balances`	Return portfolio holdings (available, reserved, total) for the connected Revolut X account.
`get_tickers`	Retrieve current bid, ask, and mid prices for trading pairs.
`get_candles`	Fetch candlestick (OHLCV) data for a symbol at a configurable interval.
`get_order_book`	View order book depth for a given trading pair.
`get_orders`	Retrieve active and historical orders on the account.
`monitoring_indicators`	Compute technical indicators and alerts (RSI, EMA crossovers, MACD, Bollinger Bands, volume spikes, spread, OBI, ATR breakouts).
`backtest_grid_strategy`	Simulate the performance of a grid trading strategy over historical data.

Setup Guide

Prerequisites

Node.js installed locally
A Revolut X account with API access enabled
Git

Install and build

git clone https://github.com/revolut-engineering/revolut-x-api.git
cd revolut-x-api
npm ci
npm run build -w api
npm run build -w mcp

Configure Claude Desktop

Edit your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the server entry:

{
  "mcpServers": {
    "revolutx": {
      "command": "node",
      "args": ["/path/to/revolut-x-api/mcp/dist/index.js"]
    }
  }
}

Replace /path/to/revolut-x-api with the absolute path to your clone.

Authenticate

Restart Claude Desktop and prompt:

Set up my Revolut X API keys

The server will:

Generate an Ed25519 keypair locally.
Print the public key for you to register at Revolut X under Profile > API Keys.
Accept the API key issued by the exchange and store it locally.
Verify connectivity.

Credentials live in ~/.config/revolut-x/ (macOS/Linux) or %APPDATA%\revolut-x\ (Windows). Override with the REVOLUTX_CONFIG_DIR environment variable. Do not paste credentials into third-party MCP proxies, the server is intended to run locally.

Use Cases

Pull current balances and open positions across Revolut X trading pairs without leaving your chat client.
Ask Claude for live tickers, candles, and order book snapshots to support discretionary trading decisions.
Run technical indicator scans (RSI, MACD, Bollinger Bands, volume spikes) across a watchlist and surface signals.
Backtest and tune grid trading strategies on historical Revolut X data before deploying them externally.
Build read-only monitoring dashboards or alerting agents that watch spreads, ATR breakouts, or order book imbalance.

Example Prompts

"Set up my Revolut X API keys."
"Show me my current Revolut X balances and which assets are reserved in open orders."
"Pull 1h candles for BTC/USDC over the last 7 days and flag any RSI readings above 70 or below 30."
"Snapshot the order book for ETH/USDC and tell me the bid/ask spread and order book imbalance."
"Backtest a grid strategy on SOL/USDC with 20 levels between $120 and $180 over the last 90 days."

Pros

Officially maintained by the Revolut Engineering organization, not a community fork.
Read-only by design, so the blast radius from an AI mistake is limited to information retrieval.
Zero runtime dependencies in the API package, easy to audit and run locally.
Includes built-in grid strategy backtesting and a wide set of technical indicators, not just raw API wrappers.

Limitations

No order placement, modification, or cancellation, so it cannot fully automate trading on its own.
Requires a manual clone and build step, there is no published npm package or hosted endpoint.
Limited to Revolut X users with API access; not usable for general crypto market data without an account.

Alternatives

ccxt-mcp for unified read/write access to many exchanges via CCXT.
Coinbase Advanced Trade MCP style community servers for Coinbase-native trading and market data.
Binance community MCP servers for similar market data and account tooling against Binance.