
KoKo Finance — Credit Card Advisor
Connects Claude to a hosted credit card recommendation engine with 100+ US cards in the database. Exposes 14 tools covering search, side-by-side comparison, portfolio optimization with keep/cancel verdicts, merchant-specific card selection, benefit tracking, and renewal analysis. Takes optional personalization params like spending patterns, credit tier, primary goal (maximize rewards vs minimize fees vs travel perks), and issuer preferences to tune recommendations. All calculations run server-side at kokofinance.net, so there's no local setup or API key. Includes five conversation starter prompts for common workflows like portfolio review and new card finder. Useful if you're building card recommendation flows or want Claude to answer "which card should I use at Whole Foods" without hardcoding reward math.
- GitHub stars
- 1
- tools
- 14
- transport
- HTTP
- last updated
- Aug 29, 2026
Tools
14 toolsPublic tool metadata for what this MCP can expose to an agent.
search_credit_cardsNatural language search across 100+ US credit cards. Optional filters: card_type, issuer, max_annual_fee, credit_tier
Natural language search across 100+ US credit cards. Optional filters: card_type, issuer, max_annual_fee, credit_tier
No parameter schema in public metadata yet.
compare_cardsSide-by-side comparison of 2-3 cards with fees, rewards, net value, and break-even. Optional: credit_tier, primary_goal, issuer_preferences (<100ms)
Side-by-side comparison of 2-3 cards with fees, rewards, net value, and break-even. Optional: credit_tier, primary_goal, issuer_preferences (<100ms)
No parameter schema in public metadata yet.
get_card_detailsFull details for a specific card (fees, rewards, benefits)
Full details for a specific card (fees, rewards, benefits)
No parameter schema in public metadata yet.
calculate_card_valueAnnual fee break-even analysis with first-year and ongoing value
Annual fee break-even analysis with first-year and ongoing value
No parameter schema in public metadata yet.
optimize_portfolioPortfolio health score, per-card KEEP/OPTIMIZE/CANCEL verdicts. Optional: point_balances, benefit_selections, credit_tier, primary_goal, issuer_preferences, analysis_type, cancel_threshold, keep_threshold (<100ms)
Portfolio health score, per-card KEEP/OPTIMIZE/CANCEL verdicts. Optional: point_balances, benefit_selections, credit_tier, primary_goal, issuer_preferences, analysis_type, cancel_threshold, keep_threshold (<100ms)
No parameter schema in public metadata yet.
recommend_card_for_categoryBest card to use for a specific spending category, ranked by reward value. Optional: spending, credit_tier, primary_goal, issuer_preferences (<100ms)
Best card to use for a specific spending category, ranked by reward value. Optional: spending, credit_tier, primary_goal, issuer_preferences (<100ms)
No parameter schema in public metadata yet.
check_card_renewalShould you renew this card? Verdict + downgrade/replacement options. Optional: benefit_selections, acquired_date, credit_tier, primary_goal, renewal_cancel_threshold, renewal_keep_threshold
Should you renew this card? Verdict + downgrade/replacement options. Optional: benefit_selections, acquired_date, credit_tier, primary_goal, renewal_cancel_threshold, renewal_keep_threshold
No parameter schema in public metadata yet.
create_mcp_sessionSession tracking for multi-query conversations
Session tracking for multi-query conversations
No parameter schema in public metadata yet.
which_card_at_merchantBest card from your portfolio at a specific merchant. Auto-detects spending category (e.g. Starbucks → dining) and ranks by reward value
Best card from your portfolio at a specific merchant. Auto-detects spending category (e.g. Starbucks → dining) and ranks by reward value
No parameter schema in public metadata yet.
check_merchant_benefitsCheck if any cards have credits at a merchant (e.g. Saks → Amex Platinum $100 credit). Includes earning recommendation
Check if any cards have credits at a merchant (e.g. Saks → Amex Platinum $100 credit). Includes earning recommendation
No parameter schema in public metadata yet.
get_card_benefitsAll credits/benefits for a card with value, frequency, schedule, and conditions
All credits/benefits for a card with value, frequency, schedule, and conditions
No parameter schema in public metadata yet.
get_card_termsSchumer Box data — purchase APR, penalty APR, late fees, cash advance fees, promotional APR, grace period
Schumer Box data — purchase APR, penalty APR, late fees, cash advance fees, promotional APR, grace period
No parameter schema in public metadata yet.
get_card_changesAudit log of card data changes (fee updates, benefit changes) with date filtering. Optional: field filter
Audit log of card data changes (fee updates, benefit changes) with date filtering. Optional: field filter
No parameter schema in public metadata yet.
get_program_trendsPoints program valuation history — CPP and transfer partner ratio changes over time
Points program valuation history — CPP and transfer partner ratio changes over time
No parameter schema in public metadata yet.
Sponsors
Readme
KoKo Finance MCP Server
A hosted MCP server for AI-powered credit card advice. Search 100+ US credit cards, compare options side by side, analyze portfolio health, and get personalized recommendations — all through the Model Context Protocol.
Server URL: https://kokofinance.net/mcp/
No local installation needed. Sign up free at kokofinance.net — 250 calls included, no credit card required — then connect your MCP client below using Google sign-in.
Quick Setup
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %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/
Or copy the .mcp.json from this repo into your project.
Cursor
Go to Settings > MCP and add a new server:
- Name: koko-finance
- Type: HTTP
- URL:
https://kokofinance.net/mcp/
Cline / Windsurf
Add to your MCP settings file:
Details
- Repository
- github.com/kokofinance/koko-mcp-server
- Category
- Search & Web Crawling
- Transport
- HTTP
- Registry
- MCP registry, active