mcpField
R
revolut-mcp

revolut-mcp

Local
github.com/jeff-nasseriFinance35Updated 3w ago
Repository

About revolut-mcp

Revolut MCP is an MCP server that connects AI assistants to the Revolut Business API. It suits users who want to query business accounts, transactions, counterparties, and exchange rates in natural language. It supports Revolut Business accounts only, defaults to the sandbox, and is released under the MIT License.

Key features

  1. 01Lists business accounts and balances
  2. 02Browses transaction records
  3. 03Manages counterparties
  4. 04Looks up live exchange rates
  5. 0521 tools grouped into eight scopes

Use cases

  1. 01Asking an AI assistant for business balances and recent transactions
  2. 02Managing counterparty records through natural-language requests
  3. 03Testing a Revolut Business API integration in the sandbox

MCP support

This project is an MCP server that exposes 21 tools for the Revolut Business API to MCP clients such as Claude Desktop and Cursor.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "jeff-nasseri-revolut": {
      "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>",
        "TOKEN_STORE_PATH": "<TOKEN_STORE_PATH>",
        "REVOLUT_ENVIRONMENT": "<REVOLUT_ENVIRONMENT>"
      }
    }
  }
}
Run commandnpx -y @jeff-nasseri/revolut-mcp
Environment variables to set
REVOLUT_CLIENT_IDClient ID from the Revolut Business portal (Settings -> APIs)
REVOLUT_PRIVATE_KEY_PATHSecretPath to the PEM private key that signs the client-assertion JWT
REVOLUT_PRIVATE_KEYSecretPEM 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 host
TOKEN_STORE_PATHSecretWhere OAuth tokens are persisted (default: ./.tokens.json)
REVOLUT_ENVIRONMENTTarget environment: sandbox (default) or production

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@jeff-nasseri/revolut-mcp0.1.6

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Revolut MCP

Revolut MCP

Pipeline Deployment Tests License: MIT

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=production with 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

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.