KoKo Finance — Credit Card Advisor

KoKo Finance MCP 服务

一款托管式 MCP 服务，为 AI 提供信用卡建议。搜索 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（<100ms）
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（<100ms）
recommend_card_for_category	针对特定消费类别推荐最佳卡片，并按奖励价值排序。可选：spending、credit_tier、primary_goal、issuer_preferences（<100ms）
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	Schumer Box 数据——购物 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

用户信用卡策略的主要目标。

Value	Meaning
"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

同一概念应用于单张卡的续卡决策。

使用于： 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 美元年费还值得吗？

“在 Starbucks 用哪张卡？”

我要在 Starbucks 买咖啡。我有 Chase Sapphire Reserve、Amex Gold 和 Citi Double Cash。哪张卡的奖励最多？

“我在 Saks 有可用额度吗？”

我正在 Saks Fifth Avenue 购物。我的卡里有没有可在这里使用的额度？我有 Amex Platinum 和 Chase Sapphire Reserve。

“Amex Platinum 有哪些权益？”

列出我的 Amex Platinum 卡的所有额度和权益——每项价值多少？

截图

使用 Claude 和 KoKo Finance MCP 服务截取的屏幕截图。

1. 搜索信用卡

“帮我找出年费低于 300 美元的最佳旅行信用卡”

2. 并排比较信用卡

“比较 Chase Sapphire Reserve 和 Amex Gold”

3. 评估信用卡组合

“分析我的信用卡组合：Chase Sapphire Reserve、Amex Gold、Citi Double Cash”

4. 在商家消费时该用哪张卡

“在 Starbucks 应该用哪张卡？”

5. 信用卡权益详情

“列出我的 Amex Platinum 的所有额度和权益”

链接

• KoKo Finance — 主网站
• 开发者文档 — 完整的 API 和工具参考
• MCP 端点 — 服务的直接 URL

另有提供

• Claude Code Plugin — 添加 MCP 服务连接，以及一个用于教 Claude 结构化信用卡工作流的 Agent Skill

隐私政策

KoKo Finance 仅收集运行 MCP 服务所需的最少数据：

• 身份验证数据：登录时的 Google OAuth 个人资料（姓名、电子邮件），或在你选择使用 API key 身份验证时收集的 API key。
• 使用日志：每次 MCP 工具调用的工具名称、参数、成功／失败状态和时间戳。用于限制速率和改进服务。
• 不与第三方共享：我们不会向第三方出售或共享个人数据。
• 数据保留：使用日志会为服务运营而保留。你可以联系我们申请删除数据。
• 联系方式：[email protected]

完整隐私政策：https://kokofinance.net/privacy.html

许可证

MIT