AwardMath MCP server

awardmath-mcp подключает AI-ассистентов к публичному API AwardMath через Model Context Protocol.

AwardMath — это оптимизатор туристических баллов. Вы указываете свои балансы баллов и цель поездки. Детерминированный решатель перебирает версионированный граф коэффициентов перевода и таблиц вознаграждений, а затем возвращает до трёх проверенных и объяснимых планов бронирования.

Расчёт — это перебор и скоринг по опубликованным таблицам. LLM может разобрать ваш вопрос и объяснить результат, но никогда не выбирает и не оптимизирует планы.

Этот репозиторий содержит MCP-сервер и бесплатный срез данных в каталоге data/. Сервер работает только на чтение. Для него не нужны API-ключ, логин или подписка, и он не собирает данные с сайтов авиакомпаний.

Инструменты

Сервер предоставляет три инструмента.

list_programs

list_programs возвращает каждую программу, которую отслеживает AwardMath, и определяет, какие идентификаторы программ решатель может задействовать сегодня.

К расходуемым программам относятся программы возна с ценами из таблиц вознаграждений, а также банковские валюты, которые переводятся в одну из таких программ. Это различие не позволяет ассистенту попросить решатель потратить баланс, у которого нет пути к оплачиваемому вознаграждению.

solve_award_trip

solve_award_trip ищет планы, подходящие под ваш кошелёк, пункты отправления, назначения, класс обслуживания, количество путешественников и лимит наличных расхов.

Успешный ответ включает до трёх планов со следующими данными:

• точные шаги перевода

• общее количество требуемых баллов

• указанные сборы

Если ни один план не подходит, в ответе содержится no_plan_reasons. Там указана причина, по которой ограничение не было выполнено, а не заполняется пробел приблизительным маршрутом или ценой.

parse_wallet

parse_wallet превращает произвольный текст в структурированный баланс.

Например:

250k Amex, 80k Chase

Понятные балансы становятся идентификаторами программ и суммами. Неднозначные фразы выводятся на уточнение, а не определяются на глаз.

Установка и запуск

Вы можете запустить сервер прямо из GitHub или установить его из клона.

Claude Code

claude mcp add awardmath -- uvx --from git+https://github.com/DanCastHub/awardmath-mcp awardmath-mcp

Claude Desktop или другой MCP-клиент с JSON-конфигурацией

{
  "mcpServers": {
    "awardmath": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/DanCastHub/awardmath-mcp", "awardmath-mcp"]
    }
  }
}

Из копии репозитория

pip install -e .
awardmath-mcp

Не нужен никакой API-ключ или учётная запись AwardMath.

Пример

Попросите своего ассистента составить план с ценой на основе вашего текущего остатка баллов.

Вы: У меня 60 000 баллов Amex Membership Rewards. Найдите одно место в эконом-классе по маршруту LAX—HNL.

Ассистент: По состоянию на 2026-08-23, лучший по цене план использовал 16 000 Qatar Avios для этого места, полученные через перевод Amex в соответствии 1:1. Ответ включает точные шаги перевода, общее количество баллов и комиссии. Он не подтверждает, что рейс доступен.

Этот результат актуален только на дату. Курсы перевода и цены вознаграждений меняются. Запустите новое решение, проконсультируйтесь с вознаграждениями и проверьте условия перевода перед переброской баллов.

Данные

Каталог data/ содержит датированный срез графа наград и выходных данных решателя.

data/transfer-ratios-current.csv

Этот файл содержит 109 ребер перевода «банк—программа» для восьми исходных валют, по состоянию, зафиксированному на 2026-08-23.

Каждая строка является самым последним наблюдением, которое AwardMath проверил по странице программы или подтвердил через независимые источники. Редакционные заявления, не проверенные таким образом, были исключены.

Включенные столбцы:

• коэффициент перевода

• комиссия

• время перевода, где подтверждено

• статус проверки

• дата наблюдения

Курсы перевода меняются. Считайте, что каждая строка действительна только на дату наблюдения, и перед переводом баллов проверяйте программу.

data/sample-solved-plans.json

Этот файл содержит пять сценариев, рассчитанных на работающем решателе 2026-08-23.

Четыре сценария дали планы, в том числе:

• LAX—HNL в эконом-классе с 60,000 баллов Amex Membership Rewards

• SFO—HND в бизнес-классе с 100,000 баллов Amex Membership Rewards, через ANA за 82 500 баллов

Одним из сценариев намеренно отсутствует. Так, сценарий бизнес-класса по маршруту YVR—DXB показывает, как решатель реагирует, когда граф не может назначить цену маршрута. Он сообщает о недостатке охвата графа, а не придумывает план.

Чего здесь нет

Набор данных — это срез, а не полный продуктых AwardMath. Версионированная история сохраняется на awardmath.com. В этой истории со временем отражаются курсы перевода, таблицы вознаграждений и вызовы истории цен или решений «бронируй сейчас—подожди». Сюда она не включена.

Что этот сервер не делает

Сервер не проверяет наличие премиальных мест в буке в реальном времени.

Планы собраны по опубликованным таблицам вознаграждений и условиям перевода. Маршрут может быть математически обоснован, но на нужные вам даты мест может не быть.

Прежде чем переводить какие-либо баллы:

1. Проверьте наличие премиальных мест через Seats.aero, PointsYeah или авиакомпанию.

2. Уточните цену в баллах и сборы в программе бронирования.

3. Перепроверьте коэффициент и переводовые условия.

Перевод баллов необратим. Не переводите их только потому, что решатель нашёл цену. Переводите, когда подтвердите, что место можно забронировать.

AwardMath проверяет математику. Вы подтверждаете место.

Лицензии

Код распространяется по лицензии MIT.

Файлы внеш участии data/ распространяются под CC BY 4.0. Укажите это атрибуция со ссылкой:

Данные: AwardMath

Источники:

• AwardMath

• репозиторий awardmath-mcp