Multi-Currency
Configure exchange rates and convert prices between currencies. Set rates manually or via scheduled task. Works with product catalog and checkout for multi-currency webshops.
Endpoints (5)
Set exchange rates for a project. Provide a base currency and rates for target currencies. Overwrites existing rates for the same pairs. Use this to configure your project's supported currencies.
| Field | Type | Required | Description |
|---|---|---|---|
base_currency |
string | ✓ Yes | Base currency ISO 4217 code (e.g. "EUR", "USD", "GBP"). |
rates |
object | ✓ Yes | Object of target_currency: rate pairs. Example: {"USD": 1.08, "GBP": 0.86, "JPY": 162.50}. Rate = how many units of target currency per 1 unit of base currency. |
Convert an amount from one currency to another using the project's configured rates. Returns the converted amount rounded to 2 decimal places.
| Field | Type | Required | Description |
|---|---|---|---|
amount |
string | ✓ Yes | Amount to convert as string (e.g. "29.99"). Use string to avoid floating point issues. |
from |
string | ✓ Yes | Source currency code (e.g. "EUR"). |
to |
string | ✓ Yes | Target currency code (e.g. "USD"). |
Get all configured exchange rates for a project. Returns base currency, target rates, and last update time.
| Field | Type | Required | Description |
|---|---|---|---|
base_currency |
string | No | Filter by base currency (optional, returns all if omitted). |
Convert multiple prices at once. Useful for converting a product listing to a different currency. Returns array of converted amounts.
| Field | Type | Required | Description |
|---|---|---|---|
amounts |
array | ✓ Yes | Array of amounts to convert (as strings). Max 100 per call. |
from |
string | ✓ Yes | Source currency code. |
to |
string | ✓ Yes | Target currency code. |
Remove exchange rates for specific currency pairs or all rates for a base currency.
| Field | Type | Required | Description |
|---|---|---|---|
base_currency |
string | ✓ Yes | Base currency to delete rates for. |
target_currency |
string | No | Specific target currency to delete. If omitted, all rates for this base are deleted. |
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| set-rates | multi-currency_set_rates |
| convert | multi-currency_convert |
| get-rates | multi-currency_get_rates |
| convert-price-list | multi-currency_convert_price_list |
| delete-rates | multi-currency_delete_rates |