pointsyeah

PointsYeah MCP サーバー

PointsYeah 経由で特典航空券や旅行のお得情報を検索する MCP サーバーです。20以上の航空会社のマイレージプログラムでポイントやマイルを使ったフライトの空席状況を検索し、主要な銀行のリワードプログラムからの移行オプションを比較できます。

機能

• 特典航空券の検索 - 複数の航空会社のプログラムでポイントやマイルを使ったフライトを検索します
• 銀行ポイントの移行比較 - Chase、Amex、Citi、Capital One、Bilt、Wells Fargoからの移行オプションを確認できます
• 検索履歴 - 過去に検索した特典航空券を確認できます

前提条件

• PointsYeah アカウント（無料またはプレミアム）
• Node.js 18+

設定

環境変数

変数	必須	説明
POINTSYEAH_REFRESH_TOKEN	いいえ	PointsYeah の AWS Cognito リフレッシュトークン（省略可能 — 実行時に set_refresh_token ツールで設定することもできます）
ENABLED_TOOLGROUPS	いいえ	有効にするツールグループをカンマ区切りで指定します（デフォルト：すべて）

認証

3つのツールはすべて常に MCP クライアントに表示されます。認証が必要なツール（search_flights、get_search_history）は、未認証の場合に set_refresh_token を案内する明確なエラーを返します。

1. トークンがない場合：search_flights または get_search_history を呼び出すと、「認証が必要です。最初に set_refresh_token ツールを呼び出してください。」というエラーが返されます。
2. 有効なトークンを設定した後（環境変数またはツール経由）：フライト検索ツールを通常どおり使用できます
3. トークンの有効期限が切れた場合、または取り消された場合：認証が必要なツールは再びエラーを返し、ユーザーに set_refresh_token の呼び出しを促します

リフレッシュトークンの取得

1. PointsYeah のサインインページにアクセスしてログインします
2. ブラウザーの DevTools（F12）を開き、［Console］を選択します
3. 次を実行します：

   document.cookie
     .split('; ')
     .find((c) => c.includes('.refreshToken='))
     .split('=')
     .slice(1)
     .join('=');
   

4. POINTSYEAH_REFRESH_TOKEN 環境変数に設定するか、実行時に set_refresh_token ツール経由で指定します

注： リフレッシュトークンの有効期限は通常30～90日です。有効期限が切れると、サーバーは自動的に set_refresh_token ツールの使用に切り替わります。

Claude Desktop の設定

Claude Desktop の設定ファイルに追加します：

{
  "mcpServers": {
    "pointsyeah": {
      "command": "npx",
      "args": ["-y", "pointsyeah-mcp-server"],
      "env": {
        "POINTSYEAH_REFRESH_TOKEN": "your-refresh-token-here"
      }
    }
  }
}

手動セットアップ

# Clone the repository
git clone https://github.com/pulsemcp/mcp-servers.git
cd mcp-servers/experimental/pointsyeah

# Install dependencies
npm run install-all

# Set up environment
export POINTSYEAH_REFRESH_TOKEN="your-refresh-token"

# Build and run
npm run build
cd local && npm start

利用可能なツール

ツール	説明	認証が必要
set_refresh_token	認証用の PointsYeah リフレッシュトークンを設定します	いいえ
search_flights	複数の航空会社のプログラムでポイントやマイルを使った特典航空券を検索します	はい
get_search_history	過去のフライト検索履歴を取得します	はい

アーキテクチャ

このサーバーは、フライト検索に2段階の方法を使用します。

1. エクスプローラー検索 - 出発空港、到着空港、日付、客室クラスを指定して、PointsYeah のエクスプローラー API に HTTP POST リクエストを送信します。CloudFront の詳細 URL を含む概要結果が返されます。
2. 詳細情報の取得 - 各詳細 URL に HTTP GET リクエストを送信して、経路、区間、移行情報の全詳細を取得します。1回の検索につき、最大10件の詳細情報を取得します。

すべての API 呼び出しでは、Cognito ID トークンを使ったプレーンな HTTP リクエストを使用して認証します。

認証フロー

PointsYeah は認証に AWS Cognito を使用します。サーバーは動的認証に対応しています。

1. 起動時に POINTSYEAH_REFRESH_TOKEN が設定されている場合、Cognito を通じて検証します。有効であれば認証済みモードになり、無効または期限切れの場合は未認証モードになります。
2. すべてのツールは常に登録されます。認証が必要なツールは呼び出し時に認証状態を確認し、未認証の場合はエラーを返します。
3. 認証後（環境変数または set_refresh_token による認証）、Cognito の InitiateAuth API を通じてリフレッシュトークンをアクセストークンと ID トークンに交換します。
4. トークンの有効期限が残り 5 分以内になると、遅延して更新します。
5. セッション中にトークンが取り消された場合（API エラーによって検出）、後続の呼び出しで再認証を求めるよう、認証状態を自動的に無効にします。

開発

# Install dependencies
npm run install-all

# Build
npm run build

# Run tests
npm test                    # Functional tests
npm run test:integration    # Integration tests (with TestMCPClient)
npm run test:all            # All tests

# Development mode
npm run dev

# Linting (from repo root)
cd ../.. && npm run lint
cd ../.. && npm run format

制限事項

• リフレッシュトークンの有効期限 - Cognito のリフレッシュトークンには有効期限があります（通常 30〜90 日）。ユーザーは再ログインしてトークンを更新する必要があります。
• 無料プランの制限 - PointsYeah は無料プランで検索頻度や検索結果数を制限する場合があります。
• API の変更 - PointsYeah がエクスプローラー API を変更した場合、検索フローの更新が必要になることがあります。