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

Related MCP server: Flow MCP

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

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Walutomat MCP Server