# revolut-mcp

Connects AI assistants to the Revolut Business API to inspect balances, view transfers, and initiate payments. Useful for tracking company finances right inside your IDE.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 34
- Author: fingentic
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/fingentic/revolut-mcp
- Updated: 2026-10-04
- HTML: https://affpapa.org/en/nevibecode/mcp/revolut-mcp

## What it does

This server hooks your coding environment into Revolut Business accounts via the Model Context Protocol. It exposes 21 distinct tools grouped into eight functional areas. Through simple requests, an assistant can fetch balance figures across currencies, pull recent ledger transactions, search counterparties, and check current FX rates.

Support is strictly confined to Revolut Business. Personal consumer accounts, crypto trading through RevolutX, and the Merchant API will not work. The runtime connects to the sandbox by default; switching to a live business profile requires setting `REVOLUT_ENVIRONMENT=production` alongside a valid production certificate.

Authentication relies on a client ID and private key credentials. Without properly generated OAuth tokens or signing certificates, the server cannot establish a session with the API.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `REVOLUT_CLIENT_ID`, `REVOLUT_PRIVATE_KEY_PATH`, `REVOLUT_PRIVATE_KEY`, `REVOLUT_REDIRECT_URI`, `REVOLUT_JWT_ISS`, `TOKEN_STORE_PATH`, `REVOLUT_ENVIRONMENT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env REVOLUT_CLIENT_ID=<REVOLUT_CLIENT_ID> --env REVOLUT_PRIVATE_KEY_PATH=<REVOLUT_PRIVATE_KEY_PATH> --env REVOLUT_PRIVATE_KEY=<REVOLUT_PRIVATE_KEY> --env REVOLUT_REDIRECT_URI=<REVOLUT_REDIRECT_URI> --env REVOLUT_JWT_ISS=<REVOLUT_JWT_ISS> --transport stdio revolut-mcp -- npx -y @jeff-nasseri/revolut-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add revolut-mcp --env REVOLUT_CLIENT_ID=<REVOLUT_CLIENT_ID> --env REVOLUT_PRIVATE_KEY_PATH=<REVOLUT_PRIVATE_KEY_PATH> --env REVOLUT_PRIVATE_KEY=<REVOLUT_PRIVATE_KEY> --env REVOLUT_REDIRECT_URI=<REVOLUT_REDIRECT_URI> --env REVOLUT_JWT_ISS=<REVOLUT_JWT_ISS> -- npx -y @jeff-nasseri/revolut-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "revolut-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@jeff-nasseri/revolut-mcp"
            ],
            "env": {
                "REVOLUT_CLIENT_ID": "<REVOLUT_CLIENT_ID>",
                "REVOLUT_PRIVATE_KEY_PATH": "<REVOLUT_PRIVATE_KEY_PATH>",
                "REVOLUT_PRIVATE_KEY": "<REVOLUT_PRIVATE_KEY>",
                "REVOLUT_REDIRECT_URI": "<REVOLUT_REDIRECT_URI>",
                "REVOLUT_JWT_ISS": "<REVOLUT_JWT_ISS>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "revolut-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@jeff-nasseri/revolut-mcp"
            ],
            "env": {
                "REVOLUT_CLIENT_ID": "<REVOLUT_CLIENT_ID>",
                "REVOLUT_PRIVATE_KEY_PATH": "<REVOLUT_PRIVATE_KEY_PATH>",
                "REVOLUT_PRIVATE_KEY": "<REVOLUT_PRIVATE_KEY>",
                "REVOLUT_REDIRECT_URI": "<REVOLUT_REDIRECT_URI>",
                "REVOLUT_JWT_ISS": "<REVOLUT_JWT_ISS>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e REVOLUT_CLIENT_ID=<REVOLUT_CLIENT_ID> -e REVOLUT_PRIVATE_KEY_PATH=<REVOLUT_PRIVATE_KEY_PATH> -e REVOLUT_PRIVATE_KEY=<REVOLUT_PRIVATE_KEY> -e REVOLUT_REDIRECT_URI=<REVOLUT_REDIRECT_URI> -e REVOLUT_JWT_ISS=<REVOLUT_JWT_ISS> revolut-mcp npx -y @jeff-nasseri/revolut-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- inspect corporate multi-currency balances
- pull ledger entries and transaction history
- check current FX exchange rates before sending funds
- create outward payments to registered counterparties

## Example prompts
- Check the current balance across all our company accounts in Revolut
- List the last five transactions from counterparty Acme Corp
- What is the live exchange rate for converting EUR to USD?

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md