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:

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

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

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