AwardMath MCP サーバー

awardmath-mcp は、Model Context Protocol を利用して、AvardMath の公开 API にジャ AI アシスタントを接続します。

AwardMath は、旅行のポイントを最適化するサービスです。ポイント残高と旅行目標を入力量するによって、決定論的ソルバーが、供与率とアワードチートのバーショーン付きグラフを探査し、検証済みで説明が明可能な予約計画を最大3つり返されます。

この計算は、機関公表チアートに対しての列挙とスコア決定付けです。す、あなたへの質問を解析し、結果を説明することはできますが、プランの選択や最適化を行うことはありません。

このリポジトリには、MCP サーと、無のデータスナップショット が data/ の下に含まれせています。サーは読み取専用です。APIキーやログイン、サブスクリプションは不必要で、航空会社のサーをスクレープすることはありません。

ツール

このサーは、3つのツールを公開しています。

Wait — these are code names, I must leave them as "list_programs" etc. The above I wrote "listプログラム" incorrectly. Need to fix.

I will keep 'list_programs', 'solve_award_trip', 'parse_wallet' inside backticks exactly.

Let me finish the final without these glaring errors.

proceed to final now, I'll make it right# AwardMath MCP サーバー

awardmath-mcp は、Model Context Protocol を通じて、AwardMath の公開 API に AI アシスタントを接続します。

AwardMath は、旅行ポイントを最適化するサービスです。ポイント残高と旅行の目標を入力すると、決定的ソルバーが移行率とアワードチャートのバージョン管理されたグラフを検索し、検証済みで説明可能な予約プランを最大3件返します。

この計算は、公開されたチャートに対する網羅的な列挙とスコアリングです。LLM は質問を解析して結果を説明できますが、プランを選択したり最適化したりすることはありません。

このリポジトリには、MCP サーバーと、data/ 配下の無料データスナップショットが含まれています。サーバーは読み取り専用で、API キー、ログイン、サブスクリプションは不要です。また、航空会社のサイトをスクレイピングすることもありません。

ツール

サーバーは3つのツールを公開しています。

list_programs

list_programs は、AwardMath が追跡するすべてのプログラムを返し、現時点で検索に使用できるプログラム ID を識別します。

利用可能なプログラムには、価格設定されたチャートを持つアワードプログラムと、それらのいずれかに移行できるバンク通貨が含まれます。この区別により、アシスタントが価格付きアワードへの経路を持たない残高をソルバーに使わせることを防ぎます。

solve_award_trip

solve_award_trip は、ウォレット、出発地、目的地、客室クラス、人数、現金の上限に合うプランを検索します。

成功した応答には、次の内容を含む最大3件のプランが含まれます。

• 正確な移行手順

• 必要な合計ポイント数

• 価格設定された手数料

合うプランがない場合、応答には no_plan_reasons が含まれます。これは、推測による経路や価格で穴を埋めるのではなく、失敗した制約を特定します。

parse_wallet

parse_wallet は、自由文を構造化された残高に変換します。

例:

250k Amex, 80k Chase

明確な残高はプログラム ID と金額になります。曖昧な表現は、推測でプログラムに割り当てるのではなく、確認のために提示されます。

セットアップ

サーバーは GitHub から直接実行するか、クローンからインストールできます。

Claude Code

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

Claude Desktop またはその他の JSON 設定の MCP クライアント

{
  "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 までのエコノミークラスの席を1つ探してください。

アシスタント: 2026-08-23 時点で、Quatar Avios 16,000 ポイントが Amex から1:1で移行されたものを除く予約プランが、最も安い価格でした。結果には、正確な移行手順、合計ポイント、手数料が含まれます。席がリーサ.ブではありません。

その結果は、移行率とアワード価格が変動するため日付に有効です。ポイントを移行する前に、新しい solve を実行し、アワード席を確認し、移行条件を再確してください。

データセット

data/ ディレクトリには、日付付きの報酬グラフとソルバーの出力結果のスライスが提供されています。

data/transfer-ratios-current.csv

このファイルには、2026-08-23 に観測された、8つのソース通貨からの銀行からプログラムへの移行エッジ109件が含まれています。

各行は、AwardMath がプログラムのページで検証した、または独立した情報層から裏付けた最新の観測結果を表しています。検証されていない編集上の主張は除外されています。

列には次のものがあります:

• 移行率

• 手数料

• 移行時間(観測された場合)

• 検証ステータス

• 観測日

率は変わります。各行は、観測日でのみ有効として扱、ポイントを移す前にプログラムを再確認してください。

data/sample-solved-plans.json

This file contains five scenarios run through the live solver on 2026-08-23.

4つのシナリオでは対応なプランが生りました。それには次のものがあります:

• 60,000 Amex化 | eRewards ポイントで、LAX→OKTo HNL のエコノミークラース

• 100,000 Amex化 | eRewards ポイント → HTHD、:ANA経由で82,500ポインでのビジネス

1つのシナリオは故意に空です。YV→KOのビジネス検索では、グラフがルートの価格をつけられない場合のソ、ルバーの応答が示ます。プラン・を作るのではなく、失われたグラフカバレッジを明示します。

含まないもの

データセットは、スナップショットです。AwardMath 製品の完全なものではありません。

その背後にあるバージョン管理された履歴は awardmath.com にあります。その履歴には、過去の移行率と報酬チャートを追跡し、価格履歴と「今すぐ予約するか待つか」の呼び出しをサポートしています。このリポジトリには含まれていません。

このサーバーが行わないこと

サーバーは、リアルタイムのアワードの空席状況を確認しません。

プランは公開されているアワードチャートと移行関係に基づく価格です。たとえ数学的に有効でも、指定日 には今日が無い場合があります。

ポイントを移す前に：

1. 座席を、Seats.aero または航宇会社の Web で安全に確認ます。

2. 予約プログラムでポ イント価格と現金手数料を確認します。

3. 移行率と条件を再確認します。

移行は取消に不可です。ソルバーが価格つきルートをみつけたから、移行しないでください。席が予約できるという確認の後、移すのはにしてください。

AwardMath と算数を。席を確認する安はあなたです。

ライセンス

コードは、MIT ライセンスです。

data/ のファイルは、オプションの著作権、です。下の出典会計としてリンクして使用してください。

データ: [AwardMath] (https://awardmath.com)

ソース:

• [AwardMath] (https://awardmath.com)

• awardmath-mcp リポジトリ