cahthuranag/mcp-server

cahthuranag/mcp-server

от cahthuranag
Сервер AllRatesToday предоставляет ИИ-ассистентам доступ к реальным курсам валют и историческим данным. Четыре MCP-инструмента для запроса текущих котировок, истории за год и списка валют — идеально для Claude, Cursor и других MCP-клиентов.

AllRatesToday MCP Server

Powered by AllRatesToday

npm version npm downloads License MCP

English | 简体中文

Give your AI coding assistant a live window into the foreign-exchange market.

A Model Context Protocol server that lets Claude Code, Cursor, Claude Desktop, Windsurf, and any other MCP-compatible client fetch real-time currency rates, historical data, and multi-currency lookups from the AllRatesToday API.

After installation, your assistant can answer questions like:

  • "What's the current USD to EUR rate?"
  • "Show me how GBP/JPY moved over the last 30 days."
  • "Convert 250 USD into CAD at a real rate."
  • "Compare USD against EUR, GBP, and JPY simultaneously."
  • "List every supported currency."

Table of contents

  • What you get
  • Get an API key (required)
  • Install
  • Quick setup per client
    • Claude Code
    • Cursor
    • Claude Desktop
    • Windsurf
    • Generic stdio MCP client
  • Verify it works
  • Tools reference
  • Environment variables
  • Plans and limits
  • Troubleshooting
  • Error reference
  • FAQ
  • Development
  • Changelog
  • Support
  • License

What you get

Capability Detail
Currencies 150+ ISO 4217 codes, all major and most exotics
Update frequency Mid-market rates refresh every ~60 seconds
Data source Tier-1 financial data providers (Reuters / Refinitiv-class)
Historical depth Up to 1 year via 1d / 7d / 30d / 1y granularity
Tools exposed 4 — get_exchange_rate, get_historical_rates, get_rates_authenticated, list_currencies
Transport stdio (subprocess), MCP 1.x compatible
Runtime Node.js ≥18
Инструменты были проиндексированы:
get_exchange_rateтолько чтениевнешний мир

Используется, когда пользователь спрашивает «что такое X в Y?», «конвертировать X в Y», «текущий курс EUR/USD» или задаёт любой другой вопрос об актуальном курсе конверсии фиатных валют. Возвращает последний среднерыночный курс в виде JSON-объекта вида { rate: 0.9234, source }, то есть 1 source = 0.9234 target. Не поддерживает криптовалюты, товарные активы или арифметику с суммами. Для нескольких целевых валют в одном вызове используется get_rates_authenticated; для прошлой даты или фиксированного периода (7d/30d/1y) используется get_historical_rates.

Получает актуальный обменный курс.

Параметры
  • sourcestringобязательный

    ISO 4217 currency code, 3 letters, case-insensitive (e.g. 'USD', 'EUR', 'GBP', 'JPY'). For a source/target pair, the returned rate is how much 1 unit of source is worth in target. Fiat only — no crypto, no commodities. Call list_currencies if unsure whether a code is supported.

  • targetstringобязательный

    ISO 4217 currency code, 3 letters, case-insensitive (e.g. 'USD', 'EUR', 'GBP', 'JPY'). For a source/target pair, the returned rate is how much 1 unit of source is worth in target. Fiat only — no crypto, no commodities. Call list_currencies if unsure whether a code is supported.

get_historical_ratesтолько чтениевнешний мир

Используйте это для вопросов с фиксированным временным окном, например: «как изменялся EUR/USD за эту неделю», «покажите последний месяц GBP/JPY» или «постройте график истории AUD/USD за год». Возвращает { source, target, period, data: [{ date, rate, timestamp }, ...] } - выборка фиксирована для каждого периода (1d - почасовая, 7d/30d - ежедневная, 1y - еженедельная), и окно всегда заканчивается СЕЙЧАС. Для конкретной даты и времени в прошлом используйте get_rates_authenticated с time. Чтобы получить один текущий курс, используйте get_exchange_rate.

Получает исторический временной ряд курсов.

Параметры
  • periodenum

    Lookback window ending NOW. '1d' returns ~24 hourly points, '7d' returns 7 daily points, '30d' returns 30 daily points, '1y' returns ~52 weekly points. Defaults to '7d' if omitted.

  • sourcestringобязательный

    ISO 4217 currency code, 3 letters, case-insensitive (e.g. 'USD', 'EUR', 'GBP', 'JPY'). For a source/target pair, the returned rate is how much 1 unit of source is worth in target. Fiat only — no crypto, no commodities. Call list_currencies if unsure whether a code is supported.

  • targetstringобязательный

    ISO 4217 currency code, 3 letters, case-insensitive (e.g. 'USD', 'EUR', 'GBP', 'JPY'). For a source/target pair, the returned rate is how much 1 unit of source is worth in target. Fiat only — no crypto, no commodities. Call list_currencies if unsure whether a code is supported.

get_rates_authenticatedтолько чтениевнешний мир

Используйте это для (a) одного источника против нескольких целевых значений в одном вызове ('USD vs EUR, GBP, JPY') или (b) курса на конкретный момент времени в прошлом ('EUR/USD at 2025-03-14T12:00Z'), при необходимости с группировкой по часу/дню/неделе/месяцу. Возвращает { rates: [{ rate, source, target, time }, ...] } - по одной строке на каждую пару целевая валюта × временной интервал. Для одной пары в реальном времени используйте get_exchange_rate. Для фиксированных окон давности (1d/7d/30d/1y, заканчивающихся сейчас) используйте get_historical_rates.

Получает многоцелевые ставки или ставки на определённый момент времени.

Параметры
  • groupenum

    Aggregation bucket: 'hour', 'day', 'week', or 'month'. Useful when time is omitted to return rolling averages. Omit for raw single-point output.

  • sourcestringобязательный

    ISO 4217 currency code, 3 letters, case-insensitive (e.g. 'USD', 'EUR', 'GBP', 'JPY'). For a source/target pair, the returned rate is how much 1 unit of source is worth in target. Fiat only — no crypto, no commodities. Call list_currencies if unsure whether a code is supported.

  • targetstringобязательный

    One or more ISO 4217 codes, comma-separated, no spaces, case-insensitive. Examples: 'EUR' (single) or 'EUR,GBP,JPY' (multi). Each target becomes a separate row in the response.

  • timestring

    Single point-in-time ISO 8601 UTC timestamp (e.g. '2025-03-14T12:00:00Z'). Omit for the latest rate.

list_currenciesтолько чтениевнешний мир

Вызывайте этот инструмент ПЕРЕД другими, если вы не уверены, поддерживается ли код валюты, или если пользователь спрашивает: «какие валюты вы поддерживаете?», «является ли X допустимой валютой?» или «какой символ у X?». Возвращает { currencies: [{ code: 'USD', name: 'US Dollar', symbol: '$' }, ...], count }, охватывающий более 150 фиатных валют ISO 4217. НЕ включает криптовалюты. Дешёвый в вызове (кешируется на 24 часа на стороне провайдера) — используйте его для проверки пользовательского ввода и предотвращения ошибок в последующих вызовах get_exchange_rate / get_rates_authenticated / get_historical_rates.

Перечисляет поддерживаемые валюты.

Параметры

Без параметров.

Похожие MCP-сервера

APOGEOAPI/apogeoapi-mcp

APOGEOAPI/apogeoapi-mcp

MCP сервер для доступа к ApogeoAPI: геоданные, курсы валют и IP-геолокация. Он позволяет ИИ-ассистентам получать актуальные данные о странах, городах и валютах прямо из диалога. Бесплатный тариф: 1000 запросов в месяц.

TypeScript1
Погода MCP

Погода MCP

MCP сервер для погоды, подключающий AI-ассистентов к 16 инструментам: прогнозы, оповещения и историческую погоду с 1940 года. Бесплатно, без API ключей и регистрации, на открытых данных NOAA и Open-Meteo.

TypeScript44
r-huijts/ns-mcp-server

r-huijts/ns-mcp-server

Этот MCP сервер подключает ИИ к Nederlandse Spoorwegen: реальные отправления, задержки и цены. Планируйте поездки по Нидерландам с учетом текущих изменений и доступности станций. Идеален для путешественников и daily commute.

TypeScript62
Pradumnasaraf/aviationstack-mcp

Pradumnasaraf/aviationstack-mcp

MCP-сервер для интеграции с AviationStack API. Предоставляет инструменты получения актуальных и исторических данных о рейсах, самолетах, аэропортах и авиалиниях. Полезен разработчикам приложений, работающих с авиационной информацией.

Python25
SidneyBissoli/bcb-br-mcp

SidneyBissoli/bcb-br-mcp

MCP сервер для доступа к временным рядам Центрального банка Бразилии (BCB/SGS). С его помощью ИИ-ассистенты могут запрашивать экономические индикаторы: Selic, IPCA, курсы валют, ВВП и более 150 других показателей из проверенного источника. Включает инструменты для поиска и сравнения данных.

TypeScript8
Курсы валют ЦБ РФ MCP

Курсы валют ЦБ РФ MCP

Сервер к открытому API Банка России: курсы валют, ключевая ставка, цены на золото/серебро/платину/палладий, конвертация. Без авторизации, корректен для выходных. Идеален для финансовых MCP-клиентов.

TypeScript1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин