RightCard

Which of your credit cards to use at any store, from verified bank data. No bank login.

OtherTypeScriptv0.1.11

RightCard MCP

npm

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.

  • No bank login. No account. Nothing stored. You pass card ids and a store name; you get an answer.
  • Honest by construction: merchant-code caveats (Costco is a warehouse club, so the grocery bonus won't post), rotating quarters with activation flags, ties named, points valued per program.
  • Cash value by default; valuation: "points" for conservative travel values.

Use it

Hosted (stateless Streamable HTTP):

https://mcp.rightcard.ai/mcp

Local (stdio, nothing leaves your machine except a read of the public catalog):

npx rightcard-mcp

Claude Desktop / Claude Code / Cursor config:

{ "mcpServers": { "rightcard": { "command": "npx", "args": ["-y", "rightcard-mcp"] } } }

Tools

toolwhat it answers
best_cardwhich of the given cards earns most at a store or category, today, with caveats
lookup_merchanthow a store is coded (category, merchant type, MCC-trap caveat)
search_cardsfind card ids by name/issuer; verified first, unverified flagged
cardone card's verified rates, rotating windows, choose-your-category spec
rotating_calendarlive + upcoming rotating windows and permanent merchant benefits

Try: "I have the Amex Gold, Freedom Flex and Citi Double Cash. Which one at Costco?"

Parity with the app

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.

Privacy

The hosted server logs request counts only. No identifiers, no cookies, no storage. Full policy: https://rightcard.ai/privacy

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y rightcard-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "ai-rightcard-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rightcard-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

rightcard-mcpnpm

Compatible MCP Clients

RightCard works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More