{
  "markdown": "# RightCard MCP\n\n[![npm](https://img.shields.io/npm/v/rightcard-mcp)](https://www.npmjs.com/package/rightcard-mcp)\n\nThe card-selection oracle for agents: **which of your credit cards should pay here?**\nAnswers come from RightCard's bank-published, two-source-verified reward data — the same\ndata the [RightCard iOS app](https://apps.apple.com/app/id6756834989) uses.\n\n- **No bank login. No account. Nothing stored.** You pass card ids and a store name; you get an answer.\n- Honest by construction: merchant-code caveats (Costco is a warehouse club, so the grocery bonus\n  won't post), rotating quarters with activation flags, ties named, points valued per program.\n- Cash value by default; `valuation: \"points\"` for conservative travel values.\n\n## Use it\n\nHosted (stateless Streamable HTTP):\n\n```\nhttps://mcp.rightcard.ai/mcp\n```\n\nLocal (stdio, nothing leaves your machine except a read of the public catalog):\n\n```\nnpx rightcard-mcp\n```\n\nClaude Desktop / Claude Code / Cursor config:\n\n```json\n{ \"mcpServers\": { \"rightcard\": { \"command\": \"npx\", \"args\": [\"-y\", \"rightcard-mcp\"] } } }\n```\n\n## Tools\n\n| tool | what it answers |\n|---|---|\n| `best_card` | which of the given cards earns most at a store or category, today, with caveats |\n| `lookup_merchant` | how a store is coded (category, merchant type, MCC-trap caveat) |\n| `search_cards` | find card ids by name/issuer; verified first, unverified flagged |\n| `card` | one card's verified rates, rotating windows, choose-your-category spec |\n| `rotating_calendar` | live + upcoming rotating windows and permanent merchant benefits |\n\nTry: \"I have the Amex Gold, Freedom Flex and Citi Double Cash. Which one at Costco?\"\n\n## Parity with the app\n\n`src/engine.ts` is a port of the iOS app's Swift engine. `fixtures/engine_golden.json` holds\n3,100+ answers produced by the Swift code over the real catalog and merchant directory;\n`npm test` fails if the port disagrees on any of them. Offers (a user's personal bank offers)\nare deliberately not part of this server — they live on the phone.\n\n## Privacy\n\nThe hosted server logs request counts only. No identifiers, no cookies, no storage.\nFull policy: https://rightcard.ai/privacy\n",
  "bytes": 2174,
  "sha": "0825e27430ab9767fc7747d7f980ab48a4b126e3cf4f1b4bf70aad1c724c5365",
  "repo_slug": "parikshitmadahar/rightcard-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_rightcard_mcp_0ef498a0/readme"
}