Wise Hybrid MCP Server
Provides tools for interacting with Wise's multi-currency business treasury API, including listing profiles and balances, fetching exchange rates and quotes, retrieving balance statements, managing recipients and transfers, and optionally creating quotes/recipients or staging and funding transfers with SCA and biometric confirmation.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Wise Hybrid MCP Server (wise-mcp)
A secure, vendor-neutral, standalone Model Context Protocol (MCP) server and Python SDK for Wise (formerly TransferWise) multi-currency business treasury, EEA/UK PSD2 Strong Customer Authentication (SCA) digital signing, foreign exchange quotes, balance statement exports, and payout staging.
๐ Highlights
Vendor-Neutral & Open-Source: Standalone Python package (
wiseSDK +wise_mcpserver), free of hardcoded proprietary data or proprietary identifiers.Triple-Lock Security Architecture:
Lock 1 (Policy): Read-only by default (
WISE_MCP_ENABLE_WRITE_TOOLS=false). Write tools are hidden from the MCP tool surface unless explicitly enabled by the operator.Lock 2 (Intent): Every write tool enforces an explicit
confirm: trueparameter, requiring the calling agent to explain and verify financial values with the human user.Lock 3 (Physical Presence): Hardware biometric presence verification via native OS modals (Touch ID / Face ID / Apple LocalAuthentication on macOS; Windows Hello PIN / Fingerprint / Facial Recognition on Windows).
EEA / UK PSD2 Strong Customer Authentication (SCA) Engine: Transparent interception of HTTP
403responses containingx-2fa-approvalheaders, automatically signing the one-time challenge token with an RSA-2048 private key viaX-Signature(SHA256withRSA) and retrying requests without human intervention.Native OS Keychain & Credential Manager Integration: Zero plain-text credentials in config files or environment variables; securely stores API Bearer tokens and RSA private keys in the OS keyring with open application ACLs on macOS to eliminate repeated password popups.
Strict Host Validation: Whitelists only official Wise endpoints (
api.wise.com,api.transferwise.com,api.sandbox.transferwise.tech,api.wise-sandbox.com).
Related MCP server: SpherePay MCP Server
๐ ๏ธ Tool Catalog (15 Tools)
Read Tools (Enabled by Default)
Tool Name | Description |
| List all personal and business profiles associated with the API token. Returns |
| Retrieve real-time multi-currency account balances and savings jars for a profile ( |
| Retrieve profile activity feed (interbalance jar movements, card payments, transfers, cashback, and fees) without requiring PSD2 SCA. Returns stripped plain text alongside Wise's inline HTML tags and pagination cursor. |
| Fetch live and historical mid-market foreign exchange rates between any currency pair (e.g., |
| Inspect an existing FX quote by ID or UUID, including guaranteed exchange rate, fee breakdown, and estimated delivery timeline. |
| Retrieve official balance statements with automatic EEA PSD2 SCA signing. Supports |
| List and search registered beneficiary bank accounts by currency, recipient name, or account identifiers. |
| List recent transfer orders and inspect their lifecycle status ( |
| Retrieve transfer details, applied exchange rates, and fee metadata for accounting and invoice reconciliation. |
Write Tools (Opt-in via WISE_MCP_ENABLE_WRITE_TOOLS=true + confirm: true + Biometric Gate)
Tool Name | Description |
| Create an authenticated quote locking in the mid-market exchange rate and transfer fee for 30 minutes. Defaults to |
| Register a new beneficiary recipient bank account (supports SEPA IBAN for EUR, UK Sort Code for GBP, South African clearing codes for ZAR, and US ACH for USD). |
| Transfer funds internally between Wise balances and savings jars ( |
| Create and queue an unfunded transfer in Wise in |
| Cancel an existing pending or unfunded transfer in Wise before it is funded or processed. |
| High-Risk Operation: Irrevocably fund and execute a pending transfer order from a Wise multi-currency balance (always requires fresh biometric prompt). |
๐ The Triple-Lock Security Model
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ AI Agent Calls Tool Execution โ
โโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโ
โ
[Lock 1] Server Policy โผ
Is WISE_MCP_ENABLE_WRITE_TOOLS=true? โโ No โโโบ [403] Tool Disabled by Policy
โ Yes
[Lock 2] Explicit Intent โผ
Did user confirm=true? โโ No โโโบ [400] Explicit Confirmation Required
โ Yes
[Lock 3] Physical Biometric โผ
Touch ID / Windows Hello Pass? โโ No โโโบ [401] Biometric Verification Denied
โ Yes
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Execute HTTP Request to Wise โ
โโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโ
โ
HTTP 403 & x-2fa-approval challenge?
โ Yes
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Sign One-Time Token (RSA-2048)โ
โ Retry with X-Signature Header โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ๐ Quickstart & Installation
1. Installation
Install via pip or uv:
# Using uv (recommended)
uv pip install wise-mcp
# Or standard pip
pip install wise-mcpOr install in development mode from source:
git clone https://github.com/hemelbesem90s/Wise-MCP.git
cd Wise-MCP
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"2. Configure Credentials in OS Keyring
Store your Wise API token securely in your operating system's native credential store:
# Stores token in macOS Keychain or Windows Credential Manager under service 'wise_mcp'
wise-mcp --set-token "your-wise-api-token"To eliminate repeated macOS password prompts when calling Keychain from command-line tools:
wise-mcp --fix-keychain-acl3. Generate Strong Customer Authentication (SCA) Keys
Under EEA/UK PSD2 regulations, sensitive actions (such as pulling balance statements or funding transfers) require 2-factor cryptographic signing.
Generate an RSA-2048 keypair directly from the CLI:
# Generates RSA-2048 keypair and stores private key in OS Keyring:
wise-mcp --generate-sca-keys
# Or save the private key to a protected local PEM file:
wise-mcp --generate-sca-keys ~/.config/wise/private.pemThe CLI prints the Public Key (-----BEGIN PUBLIC KEY----- ...) to your terminal. Save that block as wise_public.pem and upload it to Wise:
Log in to Wise Business.
Go to Settings $\rightarrow$ API tokens.
Under Manage 2FA keys (or Add new key), upload
wise_public.pemand copy your API token.
To display the public key and SHA-256 fingerprint from an existing private key in Keychain without regenerating keys:
wise-mcp --show-public-key4. Verify Setup
Run the configuration check and test your hardware biometric verification:
# Validate credentials and configuration
wise-mcp --check-config
# Test native Touch ID / Windows Hello hardware prompt
wise-mcp --test-biometricโ๏ธ Configuration Reference
Configuration can be supplied via environment variables or a .env file:
Variable | Type | Default | Description |
| String | (Keyring) | Wise API Bearer token. Recommended to store in OS keyring via |
| URL |
| Base URL for Wise API. Set to |
| Integer |
| Default profile ID. If omitted and the token has exactly one profile, it is selected automatically. |
| String | (Keyring) | RSA-2048 private key in PEM format for SCA digital signing. |
| Path |
| Path to private key |
| Boolean |
| Lock 1: Enable write operations ( |
| Boolean |
| Lock 3: Require native Touch ID / Windows Hello verification for write actions. |
| Integer |
| In-memory approval window (default: 5 min) across batch write operations (0 = prompt every call). |
| String |
| OS Keyring service identifier name. |
| String |
| Logging level ( |
| Boolean |
| Bypass host whitelist strictly for test mock servers. |
๐ฅ๏ธ MCP Client Integration
Claude Desktop (claude_desktop_config.json)
Add wise-mcp to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"wise": {
"command": "wise-mcp",
"env": {
"WISE_MCP_ENABLE_WRITE_TOOLS": "false"
}
}
}
}Note: With credentials stored in OS Keyring, you do not need to put WISE_MCP_API_TOKEN in plain text.
Google Antigravity / Cursor IDE
Add wise to your MCP configuration (mcp_config.json or workspace settings):
{
"mcpServers": {
"wise": {
"command": "/Users/user/.venv/bin/wise-mcp",
"args": [],
"env": {
"WISE_MCP_ENABLE_WRITE_TOOLS": "true",
"WISE_MCP_REQUIRE_BIOMETRIC": "true"
}
}
}
}๐งช Development & Testing
Run tests and quality checks using make or direct commands:
# Run pytest with code coverage (enforcing >=80%)
pytest --cov=wise --cov=wise_mcp -v
# Run linting and format checks
ruff check .
ruff format --check .
# Run static type checking
mypy .
# Run security static analysis
bandit -q -r wise wise_mcp๐ License
This project is licensed under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
This server cannot be deployed
Maintenance
Related MCP Connectors
Agent payments, API key vaulting, and governed mandates. Agents spend within user-defined limits.
Read-only, permission-scoped PIO team workflows for payments, payroll and employee onboarding.
Read wallets and transactions, check payees, and send or schedule transfers in PiggyVest Business.
FX protection for SMEs โ price Guards, live spot/forward rates, settlement dates, and more.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Qonto's Business API for banking operations. Supports all API key-accessible endpoints for managing business banking transactions and account information.20 PyPI3MIT
- AlicenseBqualityDmaintenanceEnables users to manage the SpherePay payment platform, including customer onboarding, bank and wallet management, and cross-chain transfers. It provides tools for executing financial workflows, tracking transfers, and configuring virtual accounts for fiat-to-stablecoin conversions.2420 PyPIAGPL 3.0

Cresium MCP Serverofficial
AlicenseAqualityBmaintenanceEnables AI tools to manage financial operations through the Cresium Partner API, including transactions, payments, invoices, and wallet balances. It supports secure workflows such as bank address lookups, transfer previews, and signature request management.125MIT- AlicenseNot gradedqualityAmaintenanceEnables read access to business data and creation of immutable action proposals that require separate human approval before idempotent execution with an audit trail.Apache 2.0