rightcard-mcp 0.1.2 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RightCard
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/data.js

@@ -25,7 +25,7 @@ async function getAll(path, fetchImpl) {
 }
 export async function loadCatalog(fetchImpl = fetch) {
     const [cardRows, overrideRows, merchantRows] = await Promise.all([
-        getAll("cards?select=id,name,issuer,reward_currency,base_rate,standard_multipliers,annual_fee,verify_status&country=eq.US&order=id", fetchImpl),
+        getAll("cards?select=id,name,issuer,reward_currency,base_rate,standard_multipliers,annual_fee,verify_status,network&country=eq.US&order=id", fetchImpl),
         getAll("active_overrides?select=*&order=id", fetchImpl),
         getAll("merchants?select=id,display_name,category,sub_key,merchant_type,is_online,aliases&country=eq.US&order=id", fetchImpl),
     ]);

package/dist/engine.d.ts

@@ -33,6 +33,8 @@ export interface RecommendInput {
     cardConfigs?: Record<string, Set<SpendCategory>>;
     now: Date;
     strictMerchantMatch?: boolean;
+    /** Register network lock (Costco = visa-only). null/undefined = no restriction. */
+    acceptedNetworks?: Set<string> | null;
 }
 export declare function formatPercent(v: number): string;
 export declare function formatMultiplier(v: number): string;

package/dist/engine.js

@@ -241,9 +241,24 @@ function subcategoryBreakdown(cards, category, overrides, cardConfigs, v, now) {
 }
 /** MerchantYieldEngine.recommend — base-rate mode (offers: []) */
 export function recommend(input) {
-    const { cards, category, overrides, now } = input;
+    const { category, overrides, now } = input;
+    let cards = input.cards;
     if (cards.length === 0)
         return null;
+    // Network-acceptance gate (Costco's Visa-only registers). Mirrors the Swift
+    // engine: a KNOWN-incompatible card can't win when a compatible (or
+    // unknown-network) card exists; if every card is known-incompatible, the
+    // full wallet answers (works on the merchant's site) and the warehouse
+    // caveat carries the register story. Unknown (null) network never gates.
+    const accepted = input.acceptedNetworks;
+    if (accepted && accepted.size > 0) {
+        const eligible = cards.filter((c) => {
+            const net = c.network?.toLowerCase();
+            return net == null || accepted.has(net);
+        });
+        if (eligible.length > 0)
+            cards = eligible;
+    }
     const v = withPooling(input.valuation, cards);
     const cardConfigs = input.cardConfigs ?? {};
     const strict = input.strictMerchantMatch ?? false;

package/dist/model.d.ts

@@ -15,6 +15,8 @@ export interface CreditCard {
     multipliers: Record<string, MultiplierField>;
     annualFee?: number | null;
     verifyStatus?: string | null;
+    /** Payment network (migration 0017): visa|mastercard|amex|discover; null = unknown, never gates. */
+    network?: string | null;
 }
 /** Supabase `cards` row → CreditCard (SupabaseCard.toCreditCard). */
 export declare function cardFromRow(row: any): CreditCard;
@@ -51,5 +53,9 @@ export interface Merchant {
 export declare function merchantFromRow(r: any): Merchant;
 /** Merchant.exclusionCaveat */
 export declare function exclusionCaveat(m: Merchant): string | null;
+/** Merchant.acceptedNetworksAtRegister — Costco's Visa-only register lock.
+ *  null for everything else (no restriction). Costco.com / online rows are
+ *  never gated (they take other networks). Mirrors the Swift twin exactly. */
+export declare function acceptedNetworksAtRegister(m: Merchant): Set<string> | null;
 /** Merchant.isCuratedBrand */
 export declare function isCuratedBrand(m: Merchant): boolean;

package/dist/model.js

@@ -27,6 +27,7 @@ export function cardFromRow(row) {
         multipliers,
         annualFee: row.annual_fee ?? null,
         verifyStatus: row.verify_status ?? null,
+        network: row.network ?? null,
     };
 }
 function fieldFromJSON(v) {
@@ -117,12 +118,31 @@ export function exclusionCaveat(m) {
     switch (m.merchantType) {
         case "superstore":
             return `${m.displayName} usually codes as a superstore (not a supermarket), so grocery bonuses often don't post — this is your best guaranteed card.`;
-        case "warehouse_club":
-            return `${m.displayName} codes as a warehouse club, so category bonuses usually don't post — this is your best guaranteed card.`;
+        case "warehouse_club": {
+            const base = `${m.displayName} codes as a warehouse club, so category bonuses usually don't post — this is your best guaranteed card.`;
+            // Costco alone is also NETWORK-locked: warehouse registers take Visa
+            // only (Costco.com takes other networks). Mirrors the Swift engine —
+            // keep both sides identical or the parity gate fails.
+            if (m.displayName.toLowerCase().includes("costco")) {
+                return base + " Note: Costco warehouses take Visa only at the register; other networks work on Costco.com.";
+            }
+            return base;
+        }
         default:
             return null;
     }
 }
+/** Merchant.acceptedNetworksAtRegister — Costco's Visa-only register lock.
+ *  null for everything else (no restriction). Costco.com / online rows are
+ *  never gated (they take other networks). Mirrors the Swift twin exactly. */
+export function acceptedNetworksAtRegister(m) {
+    const name = m.displayName.toLowerCase();
+    if (m.merchantType !== "warehouse_club" || !name.includes("costco"))
+        return null;
+    if (m.isOnline || name.includes(".com"))
+        return null;
+    return new Set(["visa"]);
+}
 /** Merchant.isCuratedBrand */
 export function isCuratedBrand(m) {
     if (m.aliases.length > 0)

package/dist/tools.js

@@ -2,7 +2,7 @@
 // and `caveats`; verified rows only in rankings; quarantined cards are NAMED, never ranked.
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { ALL_CATEGORIES, exclusionCaveat, hasAnyReward, multiplier, overrideIsActive, isPermanentMerchantBenefit } from "./model.js";
+import { ALL_CATEGORIES, acceptedNetworksAtRegister, exclusionCaveat, hasAnyReward, multiplier, overrideIsActive, isPermanentMerchantBenefit } from "./model.js";
 import { recommend, formatPercent, formatMultiplier } from "./engine.js";
 import { rankedBrandMatches, searchNormalized } from "./search.js";
 import { makeValuation, centsPerPoint, withPooling, effectiveProgram, PROGRAM_DISPLAY, TRAVEL_CPP } from "./valuation.js";
@@ -13,6 +13,10 @@ function cardSummary(c) {
     return {
         id: c.id, name: c.displayName, issuer: c.issuer, reward_currency: c.rewardCurrency,
         verify_status: c.verifyStatus ?? "unknown", annual_fee: c.annualFee ?? null,
+        // Payment network (visa|mastercard|amex|discover) or null = unknown.
+        // Stated so the model never guesses it (Costco's registers are Visa-only;
+        // a guessed network in an answer is exactly the hallucination this bans).
+        network: c.network ?? null,
     };
 }
 function resolveWallet(catalog, ids) {
@@ -92,7 +96,8 @@ export function buildServer(getCatalog) {
             configs[k] = new Set(v);
         const now = on ? new Date(on + "T00:00:00Z") : new Date();
         const r = recommend({ cards, category: cat, subKey, merchantName: merchant ?? null, overrides: catalog.overrides,
-            valuation: makeValuation(mode), cardConfigs: configs, now });
+            valuation: makeValuation(mode), cardConfigs: configs, now,
+            acceptedNetworks: dir ? acceptedNetworksAtRegister(dir) : null });
         if (!r)
             return err("No recommendation could be computed.");
         const answer = {

package/dist/valuation.d.ts

@@ -20,5 +20,7 @@ export declare function centsPerPoint(v: Valuation, card: CreditCard): number;
 export declare function valuesPointsAboveCash(v: Valuation, card: CreditCard): boolean;
 export declare function earnUnitLabel(v: Valuation, card: CreditCard): string;
 export declare function basisLabel(v: Valuation, card: CreditCard): string;
-/** Swift String(format: "%.1f") */
+/** Swift String(format: "%.1f") — printf rounds EXACT binary ties to even
+ *  (1.25 → "1.2"), where Math.round rounds them up ("1.3"). Surfaced Aug 29
+ *  2026 when a live card hit a 1.25x earn and 27 golden cases split. */
 export declare function fmt1(x: number): string;

package/dist/valuation.js

@@ -154,7 +154,13 @@ export function basisLabel(v, card) {
     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") */
+/** Swift String(format: "%.1f") — printf rounds EXACT binary ties to even
+ *  (1.25 → "1.2"), where Math.round rounds them up ("1.3"). Surfaced Aug 29
+ *  2026 when a live card hit a 1.25x earn and 27 golden cases split. */
 export function fmt1(x) {
-    return (Math.round(x * 10) / 10).toFixed(1);
+    const scaled = x * 10;
+    let r = Math.round(scaled);
+    if (scaled - Math.floor(scaled) === 0.5 && r % 2 !== 0)
+        r -= 1;
+    return (r / 10).toFixed(1);
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "rightcard-mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "mcpName": "ai.rightcard/mcp",
-  "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.",
+  "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.",
   "type": "module",
   "license": "MIT",
   "bin": {
@@ -25,7 +25,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/parikshitmadahar/rightcard-mcp"
+    "url": "git+https://github.com/rightcard/rightcard-mcp.git"
   },
   "files": [
     "dist",