{
  "markdown": "# KoKo Credit Card Advisor — Claude Code Plugin\n\nCredit card intelligence for Claude. Find and compare cards, optimize rewards. Covers break-even calculations, renewal questions, and merchant intelligence. Connects to the [KoKo Finance](https://kokofinance.net) MCP server for real-time card data and provides a skill that teaches Claude how to run these workflows.\n\n## What's Included\n\n- **MCP Server Connection** — Auto-connects to `kokofinance.net/mcp/` with 14 tools and 5 prompts for searching, comparing, and analyzing credit cards\n- **Credit Card Advisor Skill** — Teaches Claude 10 workflow patterns: portfolio review, which-card-to-use, new card finder, travel planning, large purchase planning, card renewal decisions, merchant-specific advice, benefits deep dive, card terms and cost of carry, and card change monitoring\n\n## Installation\n\n### From Claude Code CLI\n\n```bash\n# Clone and install\ngit clone https://github.com/KokoFinance/koko-credit-card-plugin.git\nclaude --plugin-dir ./koko-credit-card-plugin\n```\n\n### Manual Setup\n\nCopy the plugin directory to your Claude Code plugins location, or point to it with `--plugin-dir`.\n\n## Usage Examples\n\n### Review Your Card Portfolio\n\n> \"I have a Chase Sapphire Reserve, Amex Gold, and Citi Double Cash. Review my portfolio and tell me which cards are worth keeping.\"\n\nClaude will analyze each card's net value, give KEEP/OPTIMIZE/CANCEL verdicts, and suggest optimization strategies.\n\n### Which Card Should I Use?\n\n> \"I'm about to spend $200 on groceries. I have an Amex Gold, Chase Freedom Unlimited, and a Citi Custom Cash. Which card should I use?\"\n\nClaude will compare rewards rates across your cards for that category and recommend the best one with a pro tip.\n\n### Find a New Card\n\n> \"I spend a lot on travel and dining. I want a card with no more than $250 annual fee. What do you recommend?\"\n\nClaude will search the card database, compare the top matches side by side, and give a clear recommendation with an application link.\n\n### Should I Renew This Card?\n\n> \"I only use the Uber credit and airline fee credit on my Amex Platinum. Is it still worth paying the $695 annual fee?\"\n\nClaude will weigh year-2+ rewards and benefits against the fee and give a RENEW / DOWNGRADE / CANCEL_AND_REPLACE verdict.\n\n### Which Card at This Merchant?\n\n> \"I'm buying coffee at Starbucks. I have a Chase Sapphire Reserve, Amex Gold, and Citi Double Cash. Which card earns the most?\"\n\nClaude auto-detects the spending category for the merchant and ranks your cards by reward value.\n\n## Available MCP Tools\n\n| Tool | Description |\n|------|------------|\n| `search_credit_cards` | Natural language card search |\n| `compare_cards` | Side-by-side comparison of 2-3 cards |\n| `get_card_details` | Full details for a specific card |\n| `calculate_card_value` | Annual fee break-even analysis |\n| `optimize_portfolio` | Portfolio health score and verdicts |\n| `recommend_card_for_category` | Best card for a spending category |\n| `check_card_renewal` | RENEW/DOWNGRADE/CANCEL_AND_REPLACE verdict for a card up for renewal |\n| `which_card_at_merchant` | Best card from your portfolio at a specific merchant |\n| `check_merchant_benefits` | Check if any cards have credits at a merchant |\n| `get_card_benefits` | All credits/benefits for a card |\n| `get_card_terms` | APR, penalty fees, and other Schumer Box terms |\n| `get_card_changes` | Audit log of recent card data changes |\n| `get_program_trends` | Points program valuation history (CPP, transfer ratios) |\n| `create_mcp_session` | Session tracking across multiple queries |\n\nSeveral tools also accept optional personalization parameters (`credit_tier`, `primary_goal`, `issuer_preferences`, `spending`, and custom KEEP/CANCEL thresholds) — see the [tool guide](skills/credit-card-advisor/references/tool-guide.md) for the full parameter reference, or the [MCP server docs](https://github.com/KokoFinance/koko-mcp-server) for details shared across all MCP clients.\n\n## Links\n\n- [KoKo Finance](https://kokofinance.net) — Main site\n- [Developer Docs](https://kokofinance.net/developers.html) — MCP server documentation\n- [MCP Endpoint](https://kokofinance.net/mcp/) — Direct MCP server URL\n- [KoKo Finance MCP Server](https://github.com/KokoFinance/koko-mcp-server) — Standalone MCP server repo for non-Claude-Code clients\n\n## License\n\nMIT\n",
  "bytes": 4333,
  "sha": "1b42a2d75df9d75796cb2e61448df2d23e72fbe95f71cdb3cabeadd155554482",
  "repo_slug": "madanc/koko-credit-card-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_madanc_koko_credit_card_plugin_koko_cred_d997da92/readme"
}