mcp-wise — Claude Code MCP server: setup
Connects Claude Code to Wise for profiles, multi-currency balances, FX quotes, recipients, transfers, and webhooks.
claude mcp add --env WISE_API_TOKEN=<WISE_API_TOKEN> --env WISE_ENV=<WISE_ENV> --transport stdio wise -- npx -y @codespar/mcp-wiseWhat mcp-wise does
mcp-wise exposes Wise Platform API actions to an MCP-compatible coding agent through 21 tools. The server can inspect profiles and balances, create and retrieve FX quotes, manage payout recipients, create or fund transfers, and handle webhook subscriptions.
It runs over stdio with npx; an HTTP mode is available for server-to-server testing through MCP_HTTP=true and MCP_PORT=3000. Authentication uses the WISE_API_TOKEN Bearer token issued for a Wise profile. Set WISE_ENV to sandbox or live; sandbox is the default environment.
A valid WISE_API_TOKEN is required before the server can call Wise. Tokens belong to profiles, so each environment needs its own token.
What it helps with
- inspect Wise profiles from an agent
- create locked-rate currency quotes
- start, fund, or cancel transfers
- manage payout recipients and balances
- subscribe to Wise webhooks
Example prompts for the agent
- List the Wise profiles available to my token and show their IDs.
- Create a USD to EUR quote for this profile.
- Check the transfer status and cancel it when Wise still allows cancellation.
How to install mcp-wise
Platform CLI
claude mcp add --env WISE_API_TOKEN=<WISE_API_TOKEN> --env WISE_ENV=<WISE_ENV> --transport stdio wise -- npx -y @codespar/mcp-wiseReplace <…> with your own values
Platform CLI
codex mcp add wise --env WISE_API_TOKEN=<WISE_API_TOKEN> --env WISE_ENV=<WISE_ENV> -- npx -y @codespar/mcp-wiseReplace <…> with your own values
Config file
{
"mcpServers": {
"wise": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-wise"
],
"env": {
"WISE_API_TOKEN": "<WISE_API_TOKEN>",
"WISE_ENV": "<WISE_ENV>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"wise": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-wise"
],
"env": {
"WISE_API_TOKEN": "<WISE_API_TOKEN>",
"WISE_ENV": "<WISE_ENV>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e WISE_API_TOKEN=<WISE_API_TOKEN> -e WISE_ENV=<WISE_ENV> wise npx -y @codespar/mcp-wiseReplace <…> with your own values
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 mcp-wise
How do I install mcp-wise in Claude Code?
Run claude mcp add mcp-wise -e WISE_API_TOKEN=<WISE_API_TOKEN> -- npx -y @codespar/mcp-wise.
What does mcp-wise do?
It gives an MCP client access to Wise Platform API operations for profiles, quotes, recipients, transfers, balances, and webhooks.
What credentials does mcp-wise need?
Set WISE_API_TOKEN to the Bearer token issued for a Wise profile. WISE_ENV selects sandbox or live, and tokens are kept separately for each environment.
