The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the RightCard listing page.
The card-selection oracle for agents: which of your credit cards should pay here? Answers come from RightCard's bank-published, two-source-verified reward data — the same data the RightCard iOS app uses.
valuation: "points" for conservative travel values.Hosted (stateless Streamable HTTP):
Local (stdio, nothing leaves your machine except a read of the public catalog):
Claude Desktop / Claude Code / Cursor config:
| tool | what it answers |
|---|---|
best_card | which of the given cards earns most at a store or category, today, with caveats |
lookup_merchant | how a store is coded (category, merchant type, MCC-trap caveat) |
search_cards | find card ids by name/issuer; verified first, unverified flagged |
card | one card's verified rates, rotating windows, choose-your-category spec |
rotating_calendar | live + upcoming rotating windows and permanent merchant benefits |
Try: "I have the Amex Gold, Freedom Flex and Citi Double Cash. Which one at Costco?"
src/engine.ts is a port of the iOS app's Swift engine. fixtures/engine_golden.json holds
3,100+ answers produced by the Swift code over the real catalog and merchant directory;
npm test fails if the port disagrees on any of them. Offers (a user's personal bank offers)
are deliberately not part of this server — they live on the phone.
The hosted server logs request counts only. No identifiers, no cookies, no storage. Full policy: https://rightcard.ai/privacy