kokofinance avatar

KoKo Finance — Credit Card Advisor

kokofinance/koko-mcp-server

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 tools

Public 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:


View the full README on GitHub

Details

Repository
github.com/kokofinance/koko-mcp-server
Category
Search & Web Crawling
Transport
HTTP
Registry
MCP registry, active

Related Search & Web Crawling MCP servers

View all
1nobleblocks avatarNobleblocks Mcpnobleblocks/nobleblocks-mcpSearch 340M+ academic papers — citation graphs, semantic similarity, and AI literature reviews.1stars
2nunolima avatarGitLab Documentation MCP Servernunolima/gitlab-docs-mcpSearchable access to GitLab documentation from multiple repositories with full-text search.1stars
3nyxtoolsdev avatarClaude Memory Managernyxtoolsdev/claude-memory-managerCross-session memory for Claude Code — context capture, semantic search, recall1stars
4ojaskord avatarTender MCPojaskord/tender-mcpGovernment tender search for AI agents. UK, EU and US procurement opportunities.1stars
5prashantbtkl avatarSpresh Mcpprashantbtkl/spresh-mcpSearch Facebook ads, decode competitor creative strategy, and track brand ad history.1stars
6quotewise avatarQuotewisequotewise/mcpSemantic quote search with 600K quotes. Find quotes by meaning, verify attributions.0stars