revolut-mcp — Claude Code MCP server: what it does, how to install
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.
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-mcpWhat revolut-mcp 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.
What it helps with
- 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 for the agent
- 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?
How to install revolut-mcp
Platform CLI
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-mcpReplace <…> with your own values. 2 more environment variables are in the server README
Platform CLI
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-mcpReplace <…> with your own values. 2 more environment variables are in the server README
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values. 2 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about revolut-mcp
How to install revolut-mcp in Claude Code?
Run this command in your terminal: claude mcp add revolut-mcp -e REVOLUT_CLIENT_ID=<REVOLUT_CLIENT_ID> -e REVOLUT_PRIVATE_KEY=<REVOLUT_PRIVATE_KEY> -- npx -y @jeff-nasseri/revolut-mcp. Substitute the placeholders with your actual Revolut API credentials.
Does revolut-mcp work with personal Revolut accounts?
No, it works exclusively with Revolut Business profiles. Consumer accounts, RevolutX crypto services, and the Merchant API are not supported.
How do I switch from the sandbox to production?
By default, the server targets the test sandbox. To connect to a live account, set the environment variable REVOLUT_ENVIRONMENT=production and supply your production certificate.
