revolut-mcp
This is the Revolut MCP server
Install
npx -y @jeff-nasseri/revolut-mcpREVOLUT_CLIENT_IDrequired — Client ID from the Revolut Business portal (Settings -> APIs)REVOLUT_PRIVATE_KEY_PATHoptional — Path to the PEM private key that signs the client-assertion JWTREVOLUT_PRIVATE_KEYoptional · secret — PEM contents of the private key (alternative to REVOLUT_PRIVATE_KEY_PATH)REVOLUT_REDIRECT_URIoptional — OAuth redirect URI registered with the certificate (default: https://example.com/)REVOLUT_JWT_ISSoptional — JWT issuer; defaults to the redirect URI hostTOKEN_STORE_PATHoptional — Where OAuth tokens are persisted (default: ./.tokens.json)REVOLUT_ENVIRONMENToptional — Target environment: sandbox (default) or production
Revolut MCP
Overview
Revolut MCP is a Model Context Protocol server that bridges AI assistants (Claude, Cursor, etc.) and the Revolut Business API. Through natural-language requests an assistant can list accounts and balances, browse transactions, manage counterparties, look up live exchange rates, move money, and more — across 21 tools organized into eight scopes.
⚠️ Revolut Business only. This server works exclusively with Revolut Business accounts via the Business API. It does not support personal Revolut accounts (Open Banking), RevolutX / crypto, or the Merchant API. It defaults to the sandbox; set
REVOLUT_ENVIRONMENT=productionwith a production certificate to target a live business account.
Demo
https://github.com/user-attachments/assets/afb73925-9628-4473-b4c8-5527440357da
Documentation
📚 Full Documentation — installation, authentication, tool reference, and examples.
Quick Links
- Installation — npm, source, or Docker
- Generate a Sandbox Token — set up the Revolut Business sandbox
- Authentication — certificate setup and the OAuth flow
- Testing — unit and live integration tests
- Claude Desktop — editor integration
- Tool Reference — every tool, by scope
- Contributing — add a tool or scope
License
This MCP server is licensed under the MIT License. You are free to use, modify, and distribute it subject to the terms of that license.