mcp-currencytransfer

MCP server for the CurrencyTransfer API. Lets AI assistants trade FX, manage beneficiaries, check balances, request quotes, and configure rate alerts, market orders and RSI alerts/market orders.

Prerequisites

• Node.js 18 or newer
• A CurrencyTransfer account with API credentials

Setup

git clone https://github.com/currencytransfer/mcp-currencytransfer.git
cd mcp-currencytransfer
npm install
npm run build

Environment variables

Variable	Required	Description
CT_API_KEY	Yes	Your CurrencyTransfer account ID (Basic auth username)
CT_API_SECRET	Yes	Your CurrencyTransfer API key (Basic auth password)
CT_BASE_URL	No	API base URL. Defaults to https://app.currencytransfer.com/api/v1. Must be a currencytransfer.com subdomain or localhost.

MCP client configuration

This server uses stdio transport. Your MCP client will start it automatically — you do not need to run it in a terminal.

Add the following to your client's MCP config file. The JSON structure is the same across most clients; only the file location differs:

Client	Config file
Cursor	.cursor/mcp.json or ~/.cursor/mcp.json
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
VS Code	.vscode/mcp.json (with an MCP extension)
Windsurf	.windsurf/mcp_config.json

{
  "mcpServers": {
    "currencytransfer": {
      "command": "node",
      "args": ["<git-repo-clone-location>/mcp-currencytransfer/dist/index.js"],
      "env": {
        "CT_API_KEY": "your-account-id",
        "CT_API_SECRET": "your-api-key",
        "CT_BASE_URL": "https://stage.currencytransfer.com/api/v1"
      }
    }
  }
}

Restart your MCP client after saving the config. The server should then appear in the client's MCP settings or tool list.

Tools

The server exposes tools for:

• Currencies — tradable pairs, RSI pairs, payment methods, cut-off times
• Countries — supported countries and payment methods
• User — authenticated user profile and permissions
• Quotes — FX quote requests
• Trades — create, list, and manage trades and documents
• Beneficiaries — manage payment beneficiaries
• Balances — account balances
• Rate alerts — standard and RSI (MOEX) rate alerts and market orders