Walutomat MCP Server

Walutomat MCP Server (Beta!)

A Model Context Protocol (MCP) server that provides AI applications with access to Walutomat's currency exchange services and real-time exchange rates.

Overview

This MCP server enables AI assistants to interact with Walutomat, Poland's leading online currency exchange platform, allowing users to:

Get real-time currency exchange rates
Place currency exchange orders
Initiate transfers internally, as well as within SEPA and SWIFT zones

Usage Examples

Basic Rate Query

User: What's the current EUR to PLN exchange rate?
Assistant: I'll check the current EUR to PLN exchange rate for you using Walutomat.

Currency Conversion

User: How much is 500 USD in Polish Złoty?
Assistant: I'll convert 500 USD to PLN using current Walutomat rates.

Market Information

User: What currencies can I exchange on Walutomat?
Assistant: Let me get the list of supported currencies from Walutomat.

Available Tools

This package provides following tools

account-balance - Returns wallet balance
account-history - Returns wallet history - operations recorded on the wallet
transfer-status - Learn transfer status and details
transfer-to-wallet - Requests new internal transfer from own wallet to another wallet operated by Currency One.
transfer-to-iban - Requests new transfer from wallet where destination account number is provided in IBAN format
transfer-to-sepa - Requests new SEPA transfer from wallet where destination account number is provided in IBAN format
transfer-to-noniban - Requests new transfer from wallet to non-IBAN destinations
direct-fx-rates - Returns current exchange rate (buy and sell) offered by Currency One for specified currency pair
direct-fx-order - Requests currency exchange at rate provided by Currency One
market-fx-order - Platform allows to submit buy or sell order with price limit. Orders shall concern one of currency pairs listed on Walutomat market
market-best-offers - Returns 10 best bids and asks on currency pair in question
market-active-orders - Returns active orders, ordered by most recently submitted.

Configuration

Claude Desktop

Add the server to your Claude Desktop configuration file: MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

json

{
    "mcpServers": {
      "walutomat": {
        "command": "node",
        "args": ["dist/index.js"],
        "env": {
          "WALUTOMAT_API_KEY": "Walutomat API key",
          "WALUTOMAT_KEY_PATH": "path to RSA private key required to sign requests to Walutomat API",
          "WALUTOMAT_API_URL": "https://api.walutomat.dev for Sandbox or https://api.walutomat.pl for Prod",
          "WALUTOMAT_DRY_RUN": "true or false- true to run in dryRun mode, no real transactions are made. False otherwise. Use with caution!"
        }
      }
    }
  }

Environment Variables

Create a .env file in the project root:

WT_API_KEY=your-api-key-if-required

Development

Building from Source

# Install dependencies
npm install

# Build the project
npm run build

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This is an unofficial integration with Walutomat. Please refer to Walutomat's terms of service and API documentation for official usage guidelines.

Support

Issues: GitHub Issues
Documentation: MCP Documentation
Walutomat: Official Website

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides tools for managing wallet operations, transfers, and currency exchanges through the Walutomat platform, including balance checking, transfers, and market operations.

Related MCP Servers

chromia-mcp
chromindscan
-
security
F
license
-
quality
Enables AI to interact with Chromia Wallet for sending $CHR transactions.
Last updated -
1
TypeScript
MCP Etherscan Server
crazyrabbitLTC
A
security
A
license
A
quality
Facilitates interaction with Ethereum blockchain data via Etherscan's API, providing real-time access to balances, transactions, token transfers, contract ABIs, gas prices, and ENS name resolutions.
Last updated -
6
3
13
TypeScript
MIT License
MCP Server for Binance Spot Trading
kydlikebtc
-
security
F
license
-
quality
This server provides a robust interface for Binance spot trading operations, including secure management of API credentials, execution and management of spot orders, and monitoring of account balances and open orders.
Last updated -
169
7
TypeScript
Base MCP Serverofficial
base
-
security
A
license
-
quality
Provides onchain tools for Claude AI to interact with the Base blockchain and Coinbase API, enabling wallet management, fund transfers, and smart contract deployment.
Last updated -
136
204
TypeScript
MIT License

View all related MCP servers

Walutomat MCP Server