rightcard-mcp 0.1.0

package/dist/valuation.js

@@ -0,0 +1,160 @@
+export const PROGRAM_DISPLAY = {
+    cash: "Cash back", amexMR: "Amex Membership Rewards", chaseUR: "Chase Ultimate Rewards",
+    capOneMiles: "Capital One miles", citiTYP: "Citi ThankYou Points", wellsFargo: "Wells Fargo Rewards",
+    bilt: "Bilt Rewards", tdRewards: "TD Rewards", scenePlus: "Scene+", rbcAvion: "RBC Avion points",
+    bmoRewards: "BMO Rewards", hyatt: "World of Hyatt", marriott: "Marriott Bonvoy", ihg: "IHG One Rewards",
+    hilton: "Hilton Honors", delta: "Delta SkyMiles", united: "United MileagePlus",
+    american: "American AAdvantage", southwest: "Southwest Rapid Rewards", jetBlue: "JetBlue TrueBlue",
+    alaska: "Alaska Mileage Plan", avios: "British Airways Avios", aeroplan: "Air Canada Aeroplan",
+    fixedValue: "Fixed-value miles", genericPoints: "Points", genericMiles: "Miles",
+};
+export const TRAVEL_CPP = {
+    cash: 1.0, amexMR: 2.0, chaseUR: 2.0, capOneMiles: 1.7, citiTYP: 1.7, wellsFargo: 1.5, bilt: 2.0,
+    tdRewards: 0.5, scenePlus: 1.0, rbcAvion: 1.5, bmoRewards: 0.7,
+    hyatt: 1.7, marriott: 0.7, ihg: 0.6, hilton: 0.5,
+    delta: 1.1, united: 1.3, american: 1.4, southwest: 1.3, jetBlue: 1.3, alaska: 1.4, avios: 1.3, aeroplan: 1.3,
+    fixedValue: 1.0, genericPoints: 2.0, genericMiles: 1.5,
+};
+/** RewardProgram.cashOutCPP */
+export function cashOutCPP(p) {
+    switch (p) {
+        case "cash":
+        case "chaseUR":
+        case "citiTYP":
+        case "scenePlus": return 1.0;
+        case "amexMR": return 0.6;
+        default: return 0.5;
+    }
+}
+/** RewardProgram.infer(issuer:id:currency:) — order matters, mirrors the Swift needle list exactly. */
+export function inferProgram(issuer, id, currency) {
+    if (!currency || currency === "cashback")
+        return "cash";
+    const s = (id + " " + (issuer ?? "")).toLowerCase();
+    const has = (...n) => n.some((x) => s.includes(x));
+    if (has("hilton"))
+        return "hilton";
+    if (has("marriott", "bonvoy"))
+        return "marriott";
+    if (has("hyatt"))
+        return "hyatt";
+    if (has("ihg"))
+        return "ihg";
+    if (has("delta", "skymiles"))
+        return "delta";
+    if (has("united", "mileageplus"))
+        return "united";
+    if (has("aadvantage", "american airlines"))
+        return "american";
+    if (has("southwest", "rapid rewards"))
+        return "southwest";
+    if (has("jetblue", "trueblue"))
+        return "jetBlue";
+    if (has("alaska"))
+        return "alaska";
+    if (has("aeroplan", "air canada"))
+        return "aeroplan";
+    if (has("british airways", "avios"))
+        return "avios";
+    if (has("bilt"))
+        return "bilt";
+    if (has("scotia"))
+        return "scenePlus";
+    if (s.startsWith("td_") || s.endsWith(" td"))
+        return "tdRewards";
+    if (has("rbc"))
+        return "rbcAvion";
+    if (has("bmo"))
+        return "bmoRewards";
+    if (has("amex", "american express", "membership"))
+        return "amexMR";
+    if (has("chase", "sapphire", "freedom", "ink"))
+        return "chaseUR";
+    if (has("capital one", "capital_one", "venture"))
+        return "capOneMiles";
+    if (has("citi", "thankyou", "premier", "strata"))
+        return "citiTYP";
+    if (has("wells"))
+        return "wellsFargo";
+    if (has("arrival"))
+        return "fixedValue";
+    if (has("travel rewards", "travel_rewards"))
+        return "fixedValue";
+    if (has("discover"))
+        return "fixedValue";
+    if (has("altitude"))
+        return "fixedValue";
+    return currency === "miles" ? "genericMiles" : "genericPoints";
+}
+export function makeValuation(mode = "cash") {
+    return { mode, pooledPrograms: {} };
+}
+const hay = (c) => (c.id + " " + c.displayName).toLowerCase();
+/** RewardValuation.pooledPrograms(wallet:) */
+export function pooledPrograms(wallet) {
+    const map = {};
+    const urUnlocked = wallet.some((c) => {
+        const s = hay(c);
+        return s.includes("sapphire") || (s.includes("ink") && s.includes("preferred"));
+    });
+    if (urUnlocked) {
+        for (const c of wallet) {
+            if (c.rewardCurrency !== "cashback")
+                continue;
+            const s = hay(c);
+            if (s.includes("freedom") || (s.includes("ink") && (s.includes("cash") || s.includes("unlimited"))))
+                map[c.id] = "chaseUR";
+        }
+    }
+    const isTYPUnlock = (c) => {
+        const s = hay(c);
+        const citi = s.includes("citi") || s.includes("thankyou") || s.includes("strata");
+        return citi && (s.includes("premier") || s.includes("prestige"));
+    };
+    if (wallet.some(isTYPUnlock)) {
+        for (const c of wallet) {
+            if (c.rewardCurrency !== "cashback")
+                continue;
+            const s = hay(c);
+            if (s.includes("custom_cash") || s.includes("custom cash") || s.includes("double_cash") || s.includes("double cash"))
+                map[c.id] = "citiTYP";
+        }
+    }
+    else {
+        for (const c of wallet) {
+            if (!c.rewardCurrency || c.rewardCurrency === "cashback")
+                continue;
+            if (!isTYPUnlock(c) && inferProgram(c.issuer, c.id, c.rewardCurrency) === "citiTYP")
+                map[c.id] = "cash";
+        }
+    }
+    return map;
+}
+export function withPooling(v, wallet) {
+    return { mode: v.mode, pooledPrograms: pooledPrograms(wallet) };
+}
+export function effectiveProgram(v, card) {
+    return v.pooledPrograms[card.id] ?? inferProgram(card.issuer, card.id, card.rewardCurrency);
+}
+export function centsPerPoint(v, card) {
+    return v.mode === "cash" ? 1.0 : TRAVEL_CPP[effectiveProgram(v, card)];
+}
+export function valuesPointsAboveCash(v, card) {
+    return centsPerPoint(v, card) !== 1.0;
+}
+export function earnUnitLabel(v, card) {
+    if (v.pooledPrograms[card.id] !== undefined)
+        return "points";
+    return card.rewardCurrency ? { points: "points", miles: "miles", cashback: "cash back" }[card.rewardCurrency] : "points";
+}
+export function basisLabel(v, card) {
+    const cpp = centsPerPoint(v, card);
+    if (cpp === 1.0)
+        return "Cash value";
+    const pooled = v.pooledPrograms[card.id] !== undefined ? " (pooled with your wallet)" : "";
+    return `${PROGRAM_DISPLAY[effectiveProgram(v, card)]} · ${fmt1(cpp)}¢ travel value${pooled}`;
+}
+/** Swift String(format: "%.1f") */
+export function fmt1(x) {
+    return (Math.round(x * 10) / 10).toFixed(1);
+}

package/dist/worker.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    fetch(request: Request): Promise<Response>;
+};
+export default _default;

package/dist/worker.js

@@ -0,0 +1,38 @@
+// Cloudflare Worker: stateless Streamable HTTP MCP at POST /mcp (+ GET / for humans).
+// No sessions, no storage, no identifiers. Catalog cached in the isolate for an hour.
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { buildServer } from "./tools.js";
+import { catalogCache } from "./data.js";
+const getCatalog = catalogCache();
+const LANDING = `RightCard MCP — the card-selection oracle for agents.
+Endpoint: POST https://mcp.rightcard.ai/mcp (MCP Streamable HTTP, stateless)
+Tools: best_card · lookup_merchant · search_cards · card · rotating_calendar
+No accounts. No bank login. Nothing stored. Docs: https://rightcard.ai/mcp
+`;
+export default {
+    async fetch(request) {
+        const url = new URL(request.url);
+        if (url.pathname === "/" || url.pathname === "/health") {
+            return new Response(LANDING, { headers: { "content-type": "text/plain; charset=utf-8" } });
+        }
+        if (url.pathname !== "/mcp")
+            return new Response("not found", { status: 404 });
+        if (request.method === "OPTIONS")
+            return new Response(null, { status: 204, headers: cors() });
+        const server = buildServer(getCatalog);
+        const transport = new WebStandardStreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
+        await server.connect(transport);
+        const res = await transport.handleRequest(request);
+        const h = new Headers(res.headers);
+        for (const [k, v] of Object.entries(cors()))
+            h.set(k, v);
+        return new Response(res.body, { status: res.status, headers: h });
+    },
+};
+function cors() {
+    return {
+        "access-control-allow-origin": "*",
+        "access-control-allow-methods": "GET, POST, OPTIONS",
+        "access-control-allow-headers": "content-type, mcp-session-id, mcp-protocol-version, accept",
+    };
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "rightcard-mcp",
+  "version": "0.1.0",
+  "description": "RightCard MCP \u2014 the card-selection oracle for agents. Which of your credit cards to use at any store, from verified data. No bank login.",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "rightcard-mcp": "dist/stdio.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "export-fixtures": "echo 'run: xcodebuild test -only-testing:RightCardTests/GoldenExportTests in the iOS repo'"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0",
+    "wrangler": "^4.125.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.4.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/parikshitmadahar/rightcard-mcp"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}