io.github.jeff-nasseri/revolut-mcp
MCP server for the Revolut Business API: accounts, transactions, payments, FX, and more.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@jeff-nasseri/revolut-mcpclaude mcp add revolut-mcp -e 'REVOLUT_CLIENT_ID=<REVOLUT_CLIENT_ID>' -e 'REVOLUT_PRIVATE_KEY_PATH=<REVOLUT_PRIVATE_KEY_PATH>' -e 'REVOLUT_PRIVATE_KEY=<your revolut_private_key>' -e 'REVOLUT_REDIRECT_URI=<REVOLUT_REDIRECT_URI>' -e 'REVOLUT_JWT_ISS=<REVOLUT_JWT_ISS>' -e 'TOKEN_STORE_PATH=<TOKEN_STORE_PATH>' -e 'REVOLUT_ENVIRONMENT=<REVOLUT_ENVIRONMENT>' -- npx -y @jeff-nasseri/revolut-mcp@0.1.6
{
"mcpServers": {
"revolut-mcp": {
"command": "npx",
"args": [
"-y",
"@jeff-nasseri/revolut-mcp@0.1.6"
],
"env": {
"REVOLUT_CLIENT_ID": "<REVOLUT_CLIENT_ID>",
"REVOLUT_PRIVATE_KEY_PATH": "<REVOLUT_PRIVATE_KEY_PATH>",
"REVOLUT_PRIVATE_KEY": "<your revolut_private_key>",
"REVOLUT_REDIRECT_URI": "<REVOLUT_REDIRECT_URI>",
"REVOLUT_JWT_ISS": "<REVOLUT_JWT_ISS>",
"TOKEN_STORE_PATH": "<TOKEN_STORE_PATH>",
"REVOLUT_ENVIRONMENT": "<REVOLUT_ENVIRONMENT>"
}
}
}
}
Environment variables
REVOLUT_CLIENT_IDrequired Client ID from the Revolut Business portal (Settings -> APIs)REVOLUT_PRIVATE_KEY_PATHPath to the PEM private key that signs the client-assertion JWTREVOLUT_PRIVATE_KEYsecret PEM contents of the private key (alternative to REVOLUT_PRIVATE_KEY_PATH)REVOLUT_REDIRECT_URIOAuth redirect URI registered with the certificate (default: https://example.com/)REVOLUT_JWT_ISSJWT issuer; defaults to the redirect URI hostTOKEN_STORE_PATHWhere OAuth tokens are persisted (default: ./.tokens.json)REVOLUT_ENVIRONMENTTarget environment: sandbox (default) or production
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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.
Frequently asked questions
What is io.github.jeff-nasseri/revolut-mcp?
MCP server for the Revolut Business API: accounts, transactions, payments, FX, and more.
How do I install io.github.jeff-nasseri/revolut-mcp?
It runs on your machine. In Claude Code: claude mcp add revolut-mcp -e 'REVOLUT_CLIENT_ID=<REVOLUT_CLIENT_ID>' -e 'REVOLUT_PRIVATE_KEY_PATH=<REVOLUT_PRIVATE_KEY_PATH>' -e 'REVOLUT_PRIVATE_KEY=<your revolut_private_key>' -e 'REVOLUT_REDIRECT_URI=<REVOLUT_REDIRECT_URI>' -e 'REVOLUT_JWT_ISS=<REVOLUT_JWT_ISS>' -e 'TOKEN_STORE_PATH=<TOKEN_STORE_PATH>' -e 'REVOLUT_ENVIRONMENT=<REVOLUT_ENVIRONMENT>' -- npx -y @jeff-nasseri/revolut-mcp@0.1.6. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.jeff-nasseri/revolut-mcp need an API key?
Yes. It expects REVOLUT_CLIENT_ID, REVOLUT_PRIVATE_KEY, which you set in its configuration.
Is io.github.jeff-nasseri/revolut-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.jeff-nasseri/revolut-mcp?
It is published by jeff-nasseri. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.