cahthuranag/mcp-server

Используется, когда пользователь спрашивает «что такое 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.

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

ОФИЦИАЛЬНЫЕ курсы, которые публикует указанное учреждение: 'какой курс ECB для USD?', 'курс Bank of Japan сегодня', 'курс HMRC для выставления счетов'. Это фиксированные курсы, на которые можно ссылаться, для комплаенса, налогов, таможни и бухгалтерии, а НЕ рыночные курсы в реальном времени (для них используйте get_exchange_rate). Пропустите date для самой свежей опубликованной таблицы (API-ключ не нужен); укажите date (нужен API-ключ) для таблицы, действующей в тот день - выходные/праздники откатываются к последней опубликованной дате, и rate_date в ответе подскажет, к какой именно. Пропустите source/target для полной таблицы; укажите оба для одной пары - она пересчитывается кросс-курсом внутри собственной таблицы банка, если не опубликована напрямую, и получает флаг derived. Всегда указывайте возвращённый rate_date.

Используйте это для (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.

Среднерыночный курс AllRatesToday, публикуемый раз в день и никогда не пересматриваемый: медиана по каждой валюте на основе выборок в пятиминутном окне с центром в 16:00 по Лондону, публикуется каждый рабочий день. Использует его, когда пользователю нужен ОДИН воспроизводимый курс в день - уровни индексов, ряды доходностей, исследовательские наборы данных, отчёты на конец месяца - а не живая котировка (get_exchange_rate) или официальный курс учреждения (get_official_rates). Опускает source/target для всей таблицы; указывает оба для одной пары (кросс через USD, помечается как derived). Опускает date для последней таблицы (ключ не нужен); указывает date (API-ключ) для прошедшего рабочего дня. Не фиксинг WM/Refinitiv и не зарегистрированный бенчмарк - передаёт дисклеймер и rate_date.

Вызывайте этот инструмент ПЕРВЫМ, когда нужен код банка, или для вопросов «какие центральные банки вы охватываете?» / «есть ли у вас ставки от X?». Возвращает все охваченные источники: 121 центральный банк плюс 3 налоговых органа (HMRC, US Treasury, Swiss BAZG), с code (это то, что get_official_rates принимает как bank), названием, датой последней публикации и тем, отстаёт ли источник от графика. API-ключ не нужен.

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

Самостоятельно выпускает API-ключ AllRatesToday со 100 вызовами за весь срок, действует 7 дней, без аккаунта и без email. Используйте его, когда другой инструмент ответил "needs an API key", а пользователь хочет курсы в реальном времени, историю или таблицы по датам прямо сейчас. Сервер принимает ключ до конца сессии и возвращает его один раз - скажите пользователю положить его в конфиг MCP как ALLRATES_API_KEY, чтобы сохранить. Не больше 3 ключей на IP в день. Для постоянного ключа зарегистрируйтесь на https://allratestoday.com/register (бесплатно, 300 вызовов) или посмотрите https://allratestoday.com/pricing.