Wise MCP Server

A MCP (Machine Communication Protocol) server that serves as a gateway for the Wise API, providing simplified access to Wise's recipient functionality.

Features

• List all recipients from your Wise account via a simple MCP resource
• Automatically handles authentication and profile selection
• Uses the Wise Sandbox API for development and testing
• Available as a Docker image for easy integration

Requirements

• Python 3.12 or higher (only if installing directly)
• `uv` package manager (only if installing directly)
• Wise API token
• Docker (if using Docker image)

Get an API token

https://wise.com/your-account/integrations-and-tools/api-tokens

Create a new token here.

Installation

Option 1: Direct Installation

1. Clone this repository:

git clone https://github.com/sergeiledvanov/mcp-wise
   cd wise-mcp

2. Set up the environment:

cp .env.example .env
   # Edit .env to add your Wise API token

3. Install dependencies with `uv`:

uv venv
   uv pip install -e .

Option 2: Using Docker

You can build a Docker image:

docker build -t mcp-wise .

And add to Claude Code by adding it to your `.mcp.json`

{
  "mcpServers": {
    "mcp-wise": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e", "WISE_API_TOKEN=your_api_token_here",
        "-e", "WISE_IS_SANDBOX=true",
        "mcp-wise:latest"
      ]
    }
  }
}

Make sure to replace `your_api_token_here` with your actual Wise API token.

Make sure to also update your .mcp.json file to match your selected mode. We provide template files that you can use:

1. For stdio mode (default):

cp .mcp.json.stdio .mcp.json

2. For HTTP mode:

cp .mcp.json.http .mcp.json

These template files contain the appropriate configuration for each mode.

Available MCP Resources

The server provides the following MCP resources:

`list_recipients`

Returns a list of all recipients from your Wise account.

Parameters:

• `profile_type`: The type of profile to list recipients for. One of [personal, business]. Default: "personal"
• `currency`: Optional. Filter recipients by currency code (e.g., 'EUR', 'USD')

`get_recipient_requirements`

Fetches recipient requirements for creating a new recipient. If account details are provided, validates the account details against the requirements.

Parameters:

• `source_currency`: The source currency code (e.g., 'USD')
• `target_currency`: The target currency code (e.g., 'EUR')
• `source_amount`: The amount in the source currency
• `profile_type`: The type of profile to use. One of [personal, business]. Default: "personal"
• `account`: Optional. The recipient account details to validate against requirements. If not provided, returns the initial account requirements.

`create_recipient`

Creates a new recipient with the provided account details.

Parameters:

• `profile_type`: The type of profile to use. One of [personal, business]. Default: "personal"
• `account`: The recipient account details compliant with Wise API requirements. This should include:
  • `accountHolderName`: Name of the account holder
  • `currency`: Target currency code (e.g., 'EUR')
  • `type`: Account type (e.g., 'iban', 'sort_code', etc.)
  • `details`: Object containing account-specific details (varies by currency and country)

`send_money`

Sends money to a recipient using the Wise API.

Parameters:

• `profile_type`: The type of profile to use (personal or business)
• `source_currency`: Source currency code (e.g., 'USD')
• `source_amount`: Amount in source currency to send
• `recipient_id`: The ID of the recipient to send money to
• `payment_reference`: Optional. Reference message for the transfer (defaults to "money")
• `source_of_funds`: Optional. Source of the funds (e.g., "salary", "savings")

Configuration

Configuration is done via environment variables, which can be set in the `.env` file:

• `WISE_API_TOKEN`: Your Wise API token (required)
• `WISE_IS_SANDBOX`: Set to true to use the Wise Sandbox API (default: false)
• `MODE`: MCP Server transport mode, either "http" or "stdio" (default: stdio)

Development

Project Structure

wise-mcp/
├── .env                # Environment variables (not in git)
├── .env.example        # Example environment variables
├── pyproject.toml      # Project dependencies and configuration
├── README.md           # This file
└── src/                # Source code
    ├── main.py         # Entry point
    └── wise_mcp/       # Main package
        ├── api/        # API clients
        │   └── wise_client.py # Wise API client
        ├── resources/  # MCP resources
        │   └── recipients.py  # Recipients resource
        └── app.py      # MCP application setup

Adding New Features

To add new features:

1. Add new API client methods in `src/wise_mcp/api/wise_client.py`

2. Create new resources in `src/wise_mcp/resources/`

3. Import and register the new resources in `src/wise_mcp/app.py`

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT