{"_id":"rightcard-mcp","_rev":"6-b94008c57eac7184145fa10dfd884942","name":"rightcard-mcp","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.0":{"name":"rightcard-mcp","version":"0.1.0","license":"MIT","_id":"rightcard-mcp@0.1.0","maintainers":[{"name":"rightcard","email":"support@rightcard.ai"}],"homepage":"https://github.com/parikshitmadahar/rightcard-mcp#readme","bugs":{"url":"https://github.com/parikshitmadahar/rightcard-mcp/issues"},"bin":{"rightcard-mcp":"dist/stdio.js"},"dist":{"shasum":"d48c55409a2d995e5ed3489b66fe5ba15cea8332","tarball":"https://registry.npmjs.org/rightcard-mcp/-/rightcard-mcp-0.1.0.tgz","fileCount":22,"integrity":"sha512-B+9tmFwE9DgdhIBCog9QbVCikOWdmT3Xit9lC14Du7sI9up0HdGwyC3HrKivbRSJT8E0yRttniK/duc6HHzRuw==","signatures":[{"sig":"MEQCIH6CFgeRt3dCDcRBZ5PxHpxnhNFRGjzHB7wgLpnW8cnPAiAz/iA5tq3fFU2w7ON0SZ77MPbstxzQvgZqAeZMFypNpQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71365},"type":"module","gitHead":"63b297a4dc9823b37f4ec354285a49c3e7480f44","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","export-fixtures":"echo 'run: xcodebuild test -only-testing:RightCardTests/GoldenExportTests in the iOS repo'"},"_npmUser":{"name":"rightcard","email":"support@rightcard.ai"},"repository":{"url":"git+https://github.com/parikshitmadahar/rightcard-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"RightCard MCP — the card-selection oracle for agents. Which of your credit cards to use at any store, from verified data. No bank login.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.0","wrangler":"^4.125.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/rightcard-mcp_0.1.0_1787547141150_0.47095229891604684","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"rightcard-mcp","version":"0.1.1","license":"MIT","_id":"rightcard-mcp@0.1.1","maintainers":[{"name":"rightcard","email":"support@rightcard.ai"}],"homepage":"https://github.com/parikshitmadahar/rightcard-mcp#readme","bugs":{"url":"https://github.com/parikshitmadahar/rightcard-mcp/issues"},"bin":{"rightcard-mcp":"dist/stdio.js"},"dist":{"shasum":"f6f1e4591a2ad5f253fc7d71d40e298d1973414a","tarball":"https://registry.npmjs.org/rightcard-mcp/-/rightcard-mcp-0.1.1.tgz","fileCount":22,"integrity":"sha512-sKkKzNiie3T1+j2+01L3OH63RmW+QWahLFNtIKYM8YQf6xSIJq3FJLag8g0N5FeWkGJD/UjzHyzrMR0J26S9eQ==","signatures":[{"sig":"MEYCIQDEV08OTZBO/BMRwffBj9XAv9fNQ1pb6L+J5Kt67My3ZwIhAIih8Z24obbZRy3WfAnffRckrerpaM5T8/qOUhv/okBP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71521},"type":"module","gitHead":"f4ea39de43a4bcd37b84aa0ecd390ebc52e64f9f","mcpName":"io.github.parikshitmadahar/rightcard-mcp","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","export-fixtures":"echo 'run: xcodebuild test -only-testing:RightCardTests/GoldenExportTests in the iOS repo'"},"_npmUser":{"name":"rightcard","email":"support@rightcard.ai"},"repository":{"url":"git+https://github.com/parikshitmadahar/rightcard-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"RightCard MCP — the card-selection oracle for agents. Which of your credit cards to use at any store, from verified data. No bank login.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.0","wrangler":"^4.125.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/rightcard-mcp_0.1.1_1787550392040_0.14412013016487113","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"rightcard-mcp","version":"0.1.2","license":"MIT","_id":"rightcard-mcp@0.1.2","maintainers":[{"name":"rightcard","email":"support@rightcard.ai"}],"homepage":"https://github.com/parikshitmadahar/rightcard-mcp#readme","bugs":{"url":"https://github.com/parikshitmadahar/rightcard-mcp/issues"},"bin":{"rightcard-mcp":"dist/stdio.js"},"dist":{"shasum":"d874ea835a6e3bcec636d025a46f255ba7d6ff25","tarball":"https://registry.npmjs.org/rightcard-mcp/-/rightcard-mcp-0.1.2.tgz","fileCount":22,"integrity":"sha512-0RbXZqqkw/iWYQ3aTIHOCD88mF3C+xIMW7GxJdAThj/1DxIUh8mQFSJzBfVj/DB6l8qyAGhjX9QvyhPbdv6AtA==","signatures":[{"sig":"MEUCIQCLqQeu3iTEmmS/DJ9yzpoJkyFF9kdpDdLftSQSNQir7wIgUe3awruV9896aHl5a8qfO0jJD0M0peUCIuBATpZIqJc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71497},"type":"module","gitHead":"15941676fdc6c3ae34540a21aceb1c8f67c52107","mcpName":"ai.rightcard/mcp","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","export-fixtures":"echo 'run: xcodebuild test -only-testing:RightCardTests/GoldenExportTests in the iOS repo'"},"_npmUser":{"name":"rightcard","email":"support@rightcard.ai"},"repository":{"url":"git+https://github.com/parikshitmadahar/rightcard-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"RightCard MCP — the card-selection oracle for agents. Which of your credit cards to use at any store, from verified data. No bank login.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.0","wrangler":"^4.125.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/rightcard-mcp_0.1.2_1787631540151_0.9069547423485005","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"rightcard-mcp","version":"0.1.3","license":"MIT","_id":"rightcard-mcp@0.1.3","maintainers":[{"name":"rightcard","email":"support@rightcard.ai"}],"homepage":"https://github.com/rightcard/rightcard-mcp#readme","bugs":{"url":"https://github.com/rightcard/rightcard-mcp/issues"},"bin":{"rightcard-mcp":"dist/stdio.js"},"dist":{"shasum":"509f4b92e7bd791a64a4be4c3825007d73faea46","tarball":"https://registry.npmjs.org/rightcard-mcp/-/rightcard-mcp-0.1.3.tgz","fileCount":23,"integrity":"sha512-sHcHyPZDODIldjmZp62EyFBq8IqYrE0o6dTRpZRnlRhsPVsQGxOY3fa5BxtG9TxqcPadiUnD+oAuaFlElYzN4g==","signatures":[{"sig":"MEUCIA1zXhTKO8tTO+UIQVBkoqlUZL7RvH3b1NwI0ureWkNtAiEAizPIYeOytmg1ujk92qiDxDuaLmPGzKs7q626AIN5JFI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":75803},"type":"module","gitHead":"1bf5232baf875dbee5047f77496d570af843af1c","mcpName":"ai.rightcard/mcp","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","export-fixtures":"echo 'run: xcodebuild test -only-testing:RightCardTests/GoldenExportTests in the iOS repo'"},"_npmUser":{"name":"rightcard","email":"support@rightcard.ai"},"repository":{"url":"git+https://github.com/rightcard/rightcard-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"RightCard MCP — the card-selection oracle for agents. Which of your credit cards to use at any store, from verified data. No bank login.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.0","wrangler":"^4.125.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/rightcard-mcp_0.1.3_1789524585980_0.26545177944800935","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"rightcard-mcp","version":"0.1.4","license":"MIT","_id":"rightcard-mcp@0.1.4","maintainers":[{"name":"rightcard","email":"support@rightcard.ai"}],"homepage":"https://github.com/rightcard/rightcard-mcp#readme","bugs":{"url":"https://github.com/rightcard/rightcard-mcp/issues"},"bin":{"rightcard-mcp":"dist/stdio.js"},"dist":{"shasum":"ba63d1e6575c0e12ce4916300811f8cc99df33cc","tarball":"https://registry.npmjs.org/rightcard-mcp/-/rightcard-mcp-0.1.4.tgz","fileCount":23,"integrity":"sha512-x9DokKv/9I9YW4o97vGuMgHxEHThywPWwxkWluABwPCj/Q+zlTrGFHaxZPmRRpE2jnO2JaEu1eNgXlC5AMhi9A==","signatures":[{"sig":"MEUCIHONwgYuHJ0FYfTUwvkpml/yXeFmyeJ/SX13upvQ0ineAiEAq7FqjThES7Ba+WY422lSamZnPZV0QBoJ9r43KE5acro=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCaG27RKzMWdBg9USL02sLnYhx92kAI7cIz2YnJtjTuDAIgDdadIb99ru+7oKq30Oj+h9SCJGrZVBgaVV23y76sw8c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":79518},"type":"module","gitHead":"5fa29fdbe7d66efab889de61442ef5cf6966e8bd","mcpName":"ai.rightcard/mcp","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","export-fixtures":"echo 'run: xcodebuild test -only-testing:RightCardTests/GoldenExportTests in the iOS repo'"},"_npmUser":{"name":"rightcard","email":"support@rightcard.ai"},"repository":{"url":"git+https://github.com/rightcard/rightcard-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"RightCard MCP — the card-selection oracle for agents. Which of your credit cards to use at any store, from verified data. No bank login.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.0","wrangler":"^4.125.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/rightcard-mcp_0.1.4_1790396677629_0.0892747302850958","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"_id":"rightcard-mcp@0.1.5","bin":{"rightcard-mcp":"dist/stdio.js"},"bugs":{"url":"https://github.com/rightcard/rightcard-mcp/issues"},"dist":{"shasum":"7c7398224b04f95de00824a7453acb4ff80d615c","tarball":"https://registry.npmjs.org/rightcard-mcp/-/rightcard-mcp-0.1.5.tgz","fileCount":23,"integrity":"sha512-tbFZEkzupPc+puw3O60eS299Lk1ByvLLIjf2RbXaNtfhu4cDidCgW+v9dQ30oEQBM1t9idByTwO4O3McVFtekw==","signatures":[{"sig":"MEUCIQC0T/ZoPbW8PyGjy9epKLzlfsWIcnrc8KSjmV/HCkgIVgIgQSmON+KGszIybwh8OkABRG9naqpf5gasZRj5dFP9xnY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC81TrP20siTtimxYp0HvTldaABjGXdIm4QvyoWSd39OQIgYDkMuzurTN9rjEqu8elyclcEjRc3KG2qCGk9rNbELMM="}],"unpackedSize":79836},"name":"rightcard-mcp","type":"module","gitHead":"de3956c3a321363b25c398bd93ac8539e6627033","license":"MIT","mcpName":"ai.rightcard/mcp","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","export-fixtures":"echo 'run: xcodebuild test -only-testing:RightCardTests/GoldenExportTests in the iOS repo'"},"version":"0.1.5","_npmUser":{"name":"rightcard","email":"support@rightcard.ai"},"homepage":"https://github.com/rightcard/rightcard-mcp#readme","repository":{"url":"git+https://github.com/rightcard/rightcard-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"RightCard MCP — the card-selection oracle for agents. Which of your credit cards to use at any store, from verified data. No bank login.","directories":{},"maintainers":[{"name":"rightcard","email":"support@rightcard.ai"}],"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.1.0","wrangler":"^4.125.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/rightcard-mcp_0.1.5_1790575899046_0.288868173740886"}}},"time":{"created":"2026-08-24T04:52:20.952Z","modified":"2026-09-28T06:11:39.296Z","0.1.0":"2026-08-24T04:52:21.284Z","0.1.1":"2026-08-24T05:46:32.186Z","0.1.2":"2026-08-25T04:19:00.300Z","0.1.3":"2026-09-16T02:09:46.123Z","0.1.4":"2026-09-26T04:24:37.718Z","0.1.5":"2026-09-28T06:11:39.134Z"},"bugs":{"url":"https://github.com/rightcard/rightcard-mcp/issues"},"license":"MIT","homepage":"https://github.com/rightcard/rightcard-mcp#readme","repository":{"url":"git+https://github.com/rightcard/rightcard-mcp.git","type":"git"},"description":"RightCard MCP — the card-selection oracle for agents. Which of your credit cards to use at any store, from verified data. No bank login.","maintainers":[{"name":"rightcard","email":"support@rightcard.ai"}],"readme":"# 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","readmeFilename":"README.md"}