RevolutX MCP Server
Allows AI agents to interact with the Revolut X crypto exchange for placing orders, fetching market data, managing positions, and more.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RevolutX MCP Serverget my current account balances"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
RevolutX MCP Server
A Model Context Protocol (MCP) server for the Revolut X Crypto Exchange REST API. This server exposes a comprehensive set of tools that allow AI agents to interact with the Revolut X exchange — placing orders, fetching market data, managing positions, and more.
All private API requests are authenticated using Ed25519 request signing (X-Revx-Signature), following the official Revolut X authentication protocol.
Features
Orders
Tool | Description | Auth |
| Place a new limit or market order | ✅ Private |
| Cancel an active order by ID | ✅ Private |
| Cancel all active orders | ✅ Private |
| Get details of a specific order by ID | ✅ Private |
| Get active orders with filters (symbols, states, types, side) | ✅ Private |
| Get historical orders with date range and pagination | ✅ Private |
| Get fills (trades) for a specific order | ✅ Private |
Trades
Tool | Description | Auth |
| Get all public trades (market history) for a symbol | ✅ Private |
| Get authenticated client trade history | ✅ Private |
Market Data
Tool | Description | Auth |
| Authenticated order book snapshot for a trading pair | ✅ Private |
| Historical OHLCV candle data with configurable intervals | ✅ Private |
| Latest bid/ask/mid/last prices for all pairs | ✅ Private |
Public Market Data
Tool | Description | Auth |
| Latest 100 trades on the exchange | 🌐 Public |
| Public order book (max 5 price levels) | 🌐 Public |
Configuration
Tool | Description | Auth |
| All supported currencies and their configuration | ✅ Private |
| All traded currency pairs and their configuration | ✅ Private |
Balance
Tool | Description | Auth |
| Account balances for the authenticated user | ✅ Private |
Related MCP server: okx-trade-mcp
Prompts
Prompt | Description |
| Analyze market conditions for a specific trading pair |
| Generate a ladder trading strategy with multiple orders |
| Analyze current portfolio value based on balances and prices |
| Comprehensive portfolio risk analysis |
| Review and manage active orders with recommendations |
| Compare conditions across multiple trading pairs |
| Set up price monitoring strategy with target alerts |
Prerequisites
Node.js >= 18
npm
A Revolut X API Key (obtain from the Revolut X web app)
An Ed25519 private key (for request signing)
Installation
Clone the repository:
git clone https://github.com/Bilel-Eljaamii/revolutx-mcp.git cd revolutx-mcpInstall dependencies:
npm install
Configuration
Copy the example environment file:
cp .env.example .envEdit
.envand configure both required variables:# Your Revolut X API Key (64-character alphanumeric string) REVOLUTX_API_KEY=your_api_key_here # Your Ed25519 Private Key for request signing REVOLUTX_PRIVATE_KEY="-----BEGIN PRIVATE KEY----- your_base64_private_key_here -----END PRIVATE KEY-----"
Note: Both
REVOLUTX_API_KEYandREVOLUTX_PRIVATE_KEYare required for all private endpoints. Public endpoints (get_last_trades,get_order_book) work without authentication.
Generating an Ed25519 Key Pair
openssl genpkey -algorithm Ed25519 -out private.pem
openssl pkey -in private.pem -pubout -out public.pemUpload the public key to your Revolut X account settings, and set the contents of private.pem as REVOLUTX_PRIVATE_KEY in your .env file.
Scripts
Command | Description |
| Compile TypeScript to JavaScript |
| Build and run the server |
| Run the compiled server |
| Type-check without emitting files |
| Run ESLint on source files |
| Run ESLint with auto-fix |
| Format source files with Prettier |
| Check formatting without writing |
| Remove the |
| Clean and rebuild |
| Run tests with Jest |
Usage
Build & Run
npm run build
npm startOr in a single step:
npm run devMCP Client Configuration
To use this server with an MCP client (e.g., Claude Desktop, Cursor), add the following to your MCP client configuration:
{
"mcpServers": {
"revolutx": {
"command": "node",
"args": ["/path/to/revolutx-mcp/dist/index.js"],
"env": {
"REVOLUTX_API_KEY": "your_api_key_here",
"REVOLUTX_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nyour_base64_key\n-----END PRIVATE KEY-----"
}
}
}
}Replace /path/to/revolutx-mcp with the absolute path to your project directory.
Architecture
src/
├── index.ts # MCP server entry point
├── utils.ts # Auth (Ed25519 signing), error handling
├── tools/
│ ├── balance/
│ │ └── get_balances.ts
│ ├── configuration/
│ │ ├── get_currencies.ts
│ │ └── get_pairs.ts
│ ├── orders/
│ │ ├── place_order.ts
│ │ ├── cancel_order_by_id.ts
│ │ ├── cancel_all_orders.ts
│ │ ├── get_order_by_id.ts
│ │ ├── get_active_orders.ts
│ │ ├── get_historical_orders.ts
│ │ └── get_order_fills.ts
│ ├── trades/
│ │ ├── get_all_trades.ts
│ │ └── get_private_trades.ts
│ ├── market_data/
│ │ ├── get_order_book_snapshot.ts
│ │ ├── get_candles.ts
│ │ └── get_tickers.ts
│ └── public_market_data/
│ ├── get_last_trades.ts
│ └── get_order_book.ts
├── resources/
│ └── index.ts
└── prompts/
└── index.tsAuthentication Flow
All private API requests follow the Revolut X Ed25519 signing protocol:
Generate a timestamp (
Date.now())Concatenate:
timestamp + HTTP_METHOD + path + query + bodySign with
crypto.sign(null, message, privateKey)(pure Ed25519)Attach headers:
X-Revx-API-Key,X-Revx-Timestamp,X-Revx-Signature
API Reference
This server implements the complete Revolut X Crypto Exchange REST API:
License
ISC
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Bilel-Eljaamii/revolutx-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server