KoKo Finance — Credit Card Advisor

KoKo Finance MCP Server

AI を活用したクレジットカードアドバイスを提供するホスト型 MCP サーバーです。米国のクレジットカード 100 種類以上を検索し、選択肢を並べて比較し、ポートフォリオの健全性を分析して、パーソナライズされたおすすめを取得できます。すべて Model Context Protocol を通じて利用できます。

サーバー URL： https://kokofinance.net/mcp/

ローカルへのインストールは不要です。kokofinance.net で無料登録すると、クレジットカード情報の入力なしで 250 回分の呼び出しを利用できます。その後、Google サインインを使用して、以下の手順で MCP クライアントを接続してください。

クイックセットアップ

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "koko-finance": {
      "type": "http",
      "url": "https://kokofinance.net/mcp/"
    }
  }
}

Claude Code

claude mcp add koko-finance --transport http https://kokofinance.net/mcp/

または、このリポジトリの .mcp.json をプロジェクトにコピーしてください。

Cursor

Settings > MCP に移動し、新しいサーバーを追加します。

• 名前： koko-finance
• 種類： HTTP
• URL： https://kokofinance.net/mcp/

Cline / Windsurf

MCP 設定ファイルに追加します。

{
  "mcpServers": {
    "koko-finance": {
      "type": "http",
      "url": "https://kokofinance.net/mcp/"
    }
  }
}

ツール（14）

ツール	説明
search_credit_cards	自然言語で米国のクレジットカード 100 種類以上を検索します。任意のフィルター：card_type、issuer、max_annual_fee、credit_tier
compare_cards	手数料、特典、実質価値、損益分岐点を含め、カード 2～3 枚を並べて比較します。任意のパラメーター：credit_tier、primary_goal、issuer_preferences（100 ミリ秒未満）
get_card_details	特定のカードの詳細情報（手数料、特典、付帯サービス）を取得します
calculate_card_value	初年度および継続利用時の価値を含む、年会費の損益分岐点を分析します
optimize_portfolio	ポートフォリオの健全性スコアと、カードごとの KEEP／OPTIMIZE／CANCEL 判定を表示します。任意のパラメーター：point_balances、benefit_selections、credit_tier、primary_goal、issuer_preferences、analysis_type、cancel_threshold、keep_threshold（100 ミリ秒未満）
recommend_card_for_category	特定の支出カテゴリで使うのに最適なカードを、特典価値順に表示します。任意のパラメーター：spending、credit_tier、primary_goal、issuer_preferences（100 ミリ秒未満）
check_card_renewal	このカードを更新すべきか判定します。判定結果と、ダウングレードや代替カードの選択肢を表示します。任意のパラメーター：benefit_selections、acquired_date、credit_tier、primary_goal、renewal_cancel_threshold、renewal_keep_threshold
create_mcp_session	複数のクエリを含む会話のセッションを追跡します
which_card_at_merchant	特定の加盟店で使うのに最適なポートフォリオ内のカードを提示します。支出カテゴリ（例：Starbucks → 外食）を自動検出し、特典価値順に表示します
check_merchant_benefits	加盟店で利用できるクレジットが付いたカードがあるか確認します（例：Saks → Amex Platinum の 100 ドルのクレジット）。獲得方法のおすすめも含まれます
get_card_benefits	カードのクレジット／付帯サービスをすべて、価値、頻度、スケジュール、条件とともに表示します
get_card_terms	シューマーボックスの情報（購入 APR、ペナルティ APR、延滞手数料、キャッシング手数料、プロモーション APR、猶予期間）を取得します
get_card_changes	日付で絞り込めるカードデータの変更履歴（手数料や付帯サービスの変更など）を表示します。任意のパラメーター：field フィルター
get_program_trends	ポイントプログラムの評価履歴（CPP と移行パートナー比率の経時的な変化）を表示します

パーソナライズ用パラメーター

複数のツールでは、結果の関連性を高める任意のパラメーターを指定できます。いずれも省略可能です。省略した場合、サーバーは適切なデフォルト値（例：全国平均の支出額、発行会社による偏りなし）を使用します。

credit_tier

カードの利用資格や審査通過の可能性に影響するクレジットスコアの範囲です。

値	意味
"excellent"	750 以上
"good"	700～749
"fair"	650～699
"poor"	650 未満

使用するツール： search_credit_cards、compare_cards、optimize_portfolio、recommend_card_for_category、check_card_renewal

primary_goal

ユーザーのクレジットカード戦略における主な目的です。

値	意味
"maximize_rewards"	日常の支出でポイントやキャッシュバックを最大限に獲得する
"minimize_fees"	メリットを維持しながら年会費を抑える
"build_credit"	クレジットスコアを築く、または改善する
"travel_perks"	ラウンジの利用、旅行クレジット、ポイント移行先を優先する
"simplicity"	分かりやすい特典体系のカードを少数持つことを優先する

使用先： compare_cards、optimize_portfolio、recommend_card_for_category、check_card_renewal

issuer_preferences

特定のカード発行会社への好みや敬遠を表す、発行会社の設定オブジェクトのリストです。各項目には発行会社名を示す issuer と、カードのランキングスコアに乗算する weight が含まれます。1.0 は中立（リストにない発行会社のデフォルト値）で、1.0 より大きい値は評価を上げ、1.0 より小さい値は評価を下げます。有効な範囲は 0.1 ～ 3.0 です。

[
  {"issuer": "Chase", "weight": 1.5},
  {"issuer": "American Express", "weight": 1.2},
  {"issuer": "Capital One", "weight": 0.3}
]

使用先： compare_cards、optimize_portfolio、recommend_card_for_category

spending

全国平均の代わりに、個別の特典価値を計算するために使用する、カテゴリー別の月間支出額の辞書です。

{"dining": 500, "groceries": 800, "travel": 300, "gas": 150, "general": 2000}

使用先： compare_cards、optimize_portfolio、recommend_card_for_category、check_card_renewal、calculate_card_value

cancel_threshold / keep_threshold

KEEP／OPTIMIZE／CANCEL の判定に使うデフォルトの純価値しきい値（ドル）を上書きします。

• cancel_threshold — この値を下回るカード → CANCEL（デフォルト：-200）
• keep_threshold — この値を上回るカード → KEEP（デフォルト：100）

使用先： optimize_portfolio

renewal_cancel_threshold / renewal_keep_threshold

同じ考え方を、1枚のカードの更新判断に適用します。

使用先： check_card_renewal

acquired_date

ユーザーがカードを取得した日付（YYYY-MM-DD）です。保有期間に基づく更新分析に使用します。

使用先： check_card_renewal

レスポンスのメタデータ

計算ツールのレスポンスには、次のメタデータフィールドが含まれます。

• spending_source — "user_provided" または "national_averages"。ユーザーが指定した支出額と、BLS の全国平均のどちらを計算に使用したかを示します。
• data_source — カードデータの取得元を示します（例："koko_db"）。
• rewards_by_category — カテゴリー別の特典内訳です。比較、ポートフォリオ、価値の各ツールに含まれます。
• points_program_key / portal_cpp — ポイントプログラムの識別子と、ポータル経由で利用する場合のポイント単価です。すべてのカードデータに含まれます。

プロンプト（5件）

AI を構造化されたワークフローに沿って案内する、事前に用意された会話の開始文です。

プロンプト	説明	パラメーター
portfolio-review	健全性スコアと判定を含む、ポートフォリオ全体の分析	card_names、monthly_spending（任意）
which-card	特定の購入に最適なカードを検索	card_names、category、amount（任意）
new-card-finder	条件に合う新しいカードを検索	spending_focus、annual_fee_limit（任意）、credit_score（任意）
renewal-check	カードの更新判断を段階的に進める	card_name、annual_fee（任意）
card-risk-assessment	APR の負担、ペナルティの発生条件、手数料の落とし穴など、カードのリスク特性を分析	card_name、issuer（任意）

特典の選択

optimize_portfolio と check_card_renewal ツールは、ユーザーが実際に利用する個別の特典キーのリストである benefit_selections パラメーターを受け付けます。選択した特典は利用率 100% として、選択していない特典は利用率 0% として計算されます。

benefit_selections: ["uber", "airline_fee", "dining", "admirals_club"]

これにより、デフォルトの利用率 50% の推定値ではなく、正確な純価値を計算できます。

有効なキーを確認するには、REST エンドポイント GET https://kokofinance.net/api/v1/benefit-categories を呼び出してください（認証不要）。または、開発者向けドキュメントをご覧ください。

会話の例

「ポートフォリオを見直してください」

Chase Sapphire Reserve、Amex Gold、Citi Double Cashを持っています。ポートフォリオを分析して、どのカードを持ち続ける価値があるか教えてください。

「どのカードを使えばよいですか？」

食料品を200ドル分購入します。Amex Gold、Chase Freedom Unlimited、Citi Custom Cashを持っています。どのカードを使えばよいですか？

「新しいカードを探してください」

旅行や外食に多くお金を使います。年会費が300ドル未満で、入会ボーナスが充実したカードが欲しいです。おすすめを教えてください。

「Amex Platinumを更新すべきですか？」

Amex PlatinumではUberクレジットと航空会社手数料クレジットしか使っていません。それでも年会費695ドルを払う価値はありますか？

「スターバックスではどのカードを使えばよいですか？」

スターバックスでコーヒーを買います。Chase Sapphire Reserve、Amex Gold、Citi Double Cashを持っています。どのカードが最も多くポイントを獲得できますか？

「Saksで使えるクレジットはありますか？」

Saks Fifth Avenueで買い物をします。持っているカードに使えるクレジットはありますか？Amex PlatinumとChase Sapphire Reserveを持っています。

「Amex Platinumにはどんな特典がありますか？」

Amex Platinumカードのクレジットと特典をすべて見せてください。それぞれの価値はいくらですか？

スクリーンショット

KoKo Finance MCP サーバーを使用してClaudeから取得したスクリーンショットです。

1. クレジットカードを検索する

「年会費300ドル未満のおすすめのトラベルクレジットカードを探してください」

2. カードを並べて比較する

「Chase Sapphire ReserveとAmex Goldを比較してください」

3. ポートフォリオの見直し

「ポートフォリオを分析してください：Chase Sapphire Reserve、Amex Gold、Citi Double Cash」

4. 店舗で使うカード

「スターバックスではどのカードを使えばよいですか？」

5. カード特典の詳細

「Amex Platinumのクレジットと特典をすべて見せてください」

リンク

• KoKo Finance — メインサイト
• 開発者向けドキュメント — APIとツールの詳細リファレンス
• MCP エンドポイント — サーバーの直接URL

こちらもご利用いただけます

• Claude Code Plugin — MCP サーバーへの接続に加え、クレジットカードのワークフローを体系的にClaudeに教えるエージェントスキルを追加します

プライバシーポリシー

KoKo Financeは、MCP サーバーの運用に必要な最小限のデータを収集します。

• 認証データ：サインイン時のGoogle OAuthプロフィール（氏名、メールアドレス）、または別の方法で認証する場合はAPIキー。
• 利用ログ：各MCPツール呼び出しのツール名、パラメーター、成功／失敗のステータス、タイムスタンプ。レート制限とサービスの改善に使用します。
• 第三者との共有なし：個人データを第三者に販売または共有することはありません。
• データの保持：利用ログはサービス運用のために保持されます。削除をご希望の場合は、当社までお問い合わせください。
• 連絡先：[email protected]

プライバシーポリシー全文：https://kokofinance.net/privacy.html

ライセンス

MIT