Skip to content

Releases

0.2.30

Choose a tag to compare

@cwasley cwasley released this 18 Nov 06:48

Sign-up bonus rules and card history: earnrate now knows when each issuer lets you earn a card's welcome bonus again, and checks it against the cards you've had.

Sign-up bonuses

  • 68 cards record the issuer's published rule for getting the welcome bonus again: once per card (Amex, Chase Sapphire), a wait counted from your last bonus (Southwest's 24 months, shared across its three personal cards; Citi Double Cash's 48), or from when you opened or held the card.
  • Tell earnrate the cards you used to have, with the months you know. Offer answers leave out bonuses you likely can't get, say when the wait ends ("Not before March 2027: Chase counts 24 months from your last bonus on this card, Southwest Rapid Rewards Premier or Southwest Rapid Rewards Priority"), and ask for a month when the rule needs one.
  • A card you hold now, compared again, is checked against its issuer's rule ("since you have this card now").
  • Card search shows each card's rule ("Again? Not within 24 months: …").
  • Offers are dated from the day the offer was last read on the issuer's page ("Public offer as of Nov 17, 2026"), and a no-fee card's bonus no longer mentions a fee.

MCP tools

  • New set_card_history (15 local tools, 19 hosted). remove_card can keep the card in your history (keepHistory), and update_card records when a held card's bonus posted (bonusReceived).
  • The server's instructions ask agents about to pay with one of your cards to call best_card_for_purchase first; earnrate only picks the card.

CLI

  • earnrate history lists, adds and updates cards you used to have; earnrate remove --keep-history and --bonus-received.

Wallet file

  • Each card saved from now on records the day it was added (added), so you hear only about corrections made after it. Versions before 0.2.30 refuse a wallet file with it, so update the CLI and the Desktop extension together.

Data 2026.11.17 to 2026.11.17.2

  • IHG One Rewards (80,000), Premier (140,000), Premier Select and Business (150,000) offers; Aeroplan 60,000 (up to 80,000 with its first-months boost); Double Cash up to $200; Sapphire Preferred 75,000. Repeat-bonus rules on 68 cards.

The hosted connector and earnrate.dev already have these changes.

0.2.29

Choose a tag to compare

@cwasley cwasley released this 15 Nov 22:36

Answers that name the pick paying the bonus, issuers' own store lists, membership tiers in rankings, and streaming counted as an online purchase.

Answers

  • A card with bonus picks names the one that pays and gives only that pick's fine print: "3% cash back on gas stations and EV charging, your pick. Gas excludes EV charging billed by parking lots. Up to $2,500 of spending a quarter, then 1% cash back."
  • Stores an issuer names for a category say so ("for Bank of America Customized Cash Rewards, Bank of America names it as one"), from the lists Chase, Capital One, Barclays, U.S. Bank, Bank of America, Verizon, SoFi and Venmo publish, including stores named under a pick and with a membership tier saved.
  • Rankings give the best rate a membership tier would add: "Up to 5.25% with BofA Rewards Premier", "Up to 4% with U.S. Bank Smartly Earning Bonus, 100% tier ($100,000 or more)".
  • Streaming services count as an online purchase unless you say it's in store, so online shopping picks (Bank of America Customized Cash) pay there, and the answer says it assumed so.
  • Fee verdicts: when a fee card's break-even is far past typical spending, they say why ("because the Ink Business Cash, a no-fee card, earns more on cell phone service…"); when it never comes out ahead, they name the no-fee card that leads and the point value behind it.
  • A statement credit is explained once, on its card's line, without nested parentheses ("$15 back each month, $35 in December").

MCP tools

  • search_cards names each pick in words with the id picks takes: "TV, internet & streaming (tv-internet-streaming)".

Data 2026.11.13.2 to 2026.11.15

  • Stores other issuers name (2026.11.13.2 and .3), streaming bought online and Etsy as online retail (2026.11.13.4), and each Customized Cash pick's own fine print (2026.11.15). No rates changed.

The hosted connector and earnrate.dev already have these changes.

0.2.28

Choose a tag to compare

@cwasley cwasley released this 13 Nov 20:08

Points every cardholder gets each year, subscription credits counted in full, statement checks that name the best cards, and fixes from testing in Claude Desktop.

Answers

  • Points a card gives every year (the Venture X's 10,000 miles, JetBlue Plus 5,000, Southwest's 3,000 to 9,000) count in a year of spending and in fee verdicts, never in a single purchase.
  • Subscription credits (Walmart+, Uber One, CLEAR+, wireless and streaming credits: 15 on 7 cards) count in full once you say you use them, with no "used so far" to track. record_purchase at one marks it used unless you've said you skip it.
  • Fee verdicts name the card that overtakes past the break-even ("the Amex Blue Business Plus"), and the point values behind it ("Amex Membership Rewards at your 1.7¢ each").
  • Freedom Flex's to-do and answers say when next quarter's activation opens (Q1 2027: Dec 15, 2026).
  • Plainer wording: pick names in words ("cell phone service, streaming services"), "percentage point", Chewy bought in store, and the Amex Platinum's airline fee credit as "Set up …" in the to-do.

MCP tools

  • best_card_for_purchase no longer fails in the Claude Desktop extension when a statement credit applies (output schema).
  • compare_welcome_offers takes compare: just the cards you name.
  • Every tool refuses a parameter it doesn't take, by name, and lists the ones it does, so a misspelled one can't quietly change an answer.

Statement check

  • After comparing your own cards, the statement check names the best cards earnrate knows for those purchases. Fees are prorated only for a file covering at least 28 days.

Data 2026.11.13 and 2026.11.13.1

  • Yearly points on 8 cards; the Sapphire Preferred's 10% anniversary bonus removed; subscription credits marked; the Sapphire Reserve's spend-$75,000 quote.

The hosted connector and earnrate.dev already have these changes. On earnrate.dev this release also brings Best setups, a simpler At a store and My wallet, shorter card, store and comparison pages, Rate my wallet that builds your wallet from the cards you tap in and marks only the credit you tap, and a wallet that stays in step across tabs, Settings and Claude.

0.2.27

Choose a tag to compare

@cwasley cwasley released this 13 Nov 03:10

Online stores count as online purchases, stores an issuer names, credits earnrate can't tie to a purchase, a 13-line typical month, and the engine behind "Rate my wallet".

Answers

  • A store sold only online (Amazon, Chewy, Wayfair and the rest of online_retail) is an online purchase in every answer unless you say you're in a store, and the answer says it assumed so.
  • When an issuer names a store as earning its rate, the answer says so: "American Express names Aldi as a supermarket." American Express names twelve supermarkets and four stores that don't count on seven cards.
  • December amounts: credits that pay more in some months (the Amex Platinum's Uber Cash is $35 in December) are counted at that month's amount.
  • Freedom Flex answers say when next quarter's activation opens, where Chase says.

Credits

  • Credits earnrate can't match to a purchase (an airline fee credit for the airline you pick, a hotel credit on some bookings) are listed with their amount: twelve on eight cards, including the Amex Platinum's $200 airline fee and $600 hotel credits. They show in list_wallet, the to-do and card search, and count against a card's fee once you say you use them, but never in a purchase answer.

Typical spending

  • When no spending is given, the typical month now has 13 lines: Groceries $500, Dining $250, Gas $150, Amazon $100 (bought online), Streaming (Netflix) $40, Flights $60, Hotels $60, Other travel $30, Cell phone $115, TV and internet service $95, Transit $25, Drugstores $40 and Everything else $525.
  • Yearly figures built on it move, and fee verdicts in search_cards and earnrate cards follow: they count a card's bonus categories as they'd earn them together.
  • A simulated year is about twice as fast.

Engine

  • walletReport() (src/engine/wallet-report.ts): what a set of cards nets in a year after fees, as a range while some credits are unanswered, next to the best no-fee flat-rate card and the best pair, with the cards' fee verdicts. earnrate.dev's Rate my wallet uses it; there's no CLI command or MCP tool for it yet.
  • The to-do list has structured rows (checklistRows()) for the site; list_wallet and the CLI give the same sentences as before.

Data 2026.11.11 to 2026.11.11.3

  • Stores American Express names, December credit amounts, Q1 2027 activation start dates, and the listed credits above.

The hosted connector and earnrate.dev already have these changes. On earnrate.dev this release's work also includes Rate my wallet (with a short link that follows your wallet and a picture to save), sending your cheat sheet to someone, the statement check with a picture of its totals, year-end pages per card, and a shorter "Best card for every store".

0.2.26

Choose a tag to compare

@cwasley cwasley released this 11 Nov 04:11

Plainer wording, typical spending that counts flights, hotels and streaming, and the engine behind "Keep or replace?".

Wording

  • Answers say what a store counts as, in place of "codes as": "Assumes Whole Foods Market counts as a supermarket (MCC 5411)."
  • A store earnrate doesn't know, given a category: earnrate doesn't know "Joe's Diner", so it's treated as a restaurant here; your statement shows how it really counts.
  • "Kohl's" is no longer written "Kohl's'" in a possessive.

Typical spending

  • When no spending is given, the typical month is now Groceries $500, Dining $250, Gas $150, Amazon $100, Streaming (Netflix) $40, Flights $60, Hotels $60, Other travel $30 and Everything else $800. The one $150 Travel line counted cards with flight or hotel rates at their base rate, and the Streaming line did the same to cards that name their streaming services.
  • Figures built on it move: Amex Blue Cash Preferred is about $504 a year on its own (was $480), and the best pair about $660 (was $641).
  • Fee verdicts in search_cards and earnrate cards follow: Chase Sapphire Reserve's names restaurants, flights and hotels, and Amex Platinum's counts flights.
  • "Other travel" and similar lines ("other dining") resolve to their category.

Engine

  • keepOrReplace (src/engine/keep-or-replace.ts): what a fee card adds to a wallet, the cheaper cards that keep the most of it, the best cheaper card on the same points, and the result at a transfer value. earnrate.dev uses it in My wallet; there is no CLI command or MCP tool for it yet.
  • Categories can name extra everyday kinds of place (places), used for "Coffee shop".

Data 2026.11.10.3 to 2026.11.10.5

  • United Explorer's overlay quotes are marked as such; Amex Gold's Resy quote covers both halves of the year; fast food names "Coffee shop".

The hosted connector and earnrate.dev already have these changes. On earnrate.dev this release's work also includes the "Find a card" tab, the year-end page, tap-to-pick wallet setup, and a kind-of-place picker for stores it doesn't know.

0.2.25

Choose a tag to compare

@cwasley cwasley released this 10 Nov 13:37

Clearer answers and fixes from a full end-to-end test of the connector and the Claude Desktop extension.

Rates and fee math

  • Earning lines say what a membership you haven't given unlocks: "2x Nordy Club points at Nordstrom with Nordy Club Ambassador or Icon status", "5% … with Amazon Prime". Of BofA's Preferred Rewards tiers only the top one shows, with its cap, and none once a tier is saved.
  • A purchase beside the same purchase through a travel site reads as one: "flights booked directly or through Amex Travel" (Amex Gold, Platinum, Hilton Aspire).
  • The fee verdict says why a card's lead with its credits ends: "since each extra dollar earns less on this card than on that one", or "since a spending cap ends its lead".
  • Nordstrom's cards say their rates are what the card adds on top of the 1 point every Nordy Club member earns.

Caps and purchases

  • A cap's total stops at its limit and says what the rest earns: "$2,000 of $2,000 … the $50 past the cap earns 1% cash back".
  • Cap names read in a sentence ("Cash+'s cap on the 2 categories you pick each quarter is used up").
  • record_purchase refuses a date after today, and a purchase from an earlier period than the saved picks says that's why it can't count.
  • A credit you say you use (Uber Cash) gets its "use by" reminder.

Smaller

  • search_cards "cash+" finds only U.S. Bank Cash+.
  • A card named twice in cards says so.
  • switch_wallet and delete_wallet tell Claude to open the sign-in prompt in the same turn.
  • import_wallet names issuers left out of next-card answers.
  • Cheat-sheet membership notes give one line per card ("4% for gas and 3% for travel").
  • "valued here at 1¢"; clearing a point value names the default it goes back to.
  • list_wallet names the running earnrate version.
  • Data 2026.11.10 to 2026.11.10.2: "Car rentals"; Prime Visa's rates list stores in one order; the Nordstrom membership names Icon.

The hosted connector and earnrate.dev already have these changes.

0.2.24

Choose a tag to compare

@cwasley cwasley released this 09 Nov 23:46

Fixes search_cards in the Claude Desktop extension.

  • In 0.2.22 and 0.2.23, a search that found 3 cards or fewer returned two fields (recent changes and the welcome offer) that search_cards' declared output schema didn't list. Clients that check answers against the schema, as Claude Desktop does for the extension, rejected those searches, including "is this card worth it?" questions. The schema now lists both, and the schema test covers detailed searches.

The hosted connector and earnrate.dev already have this fix.

0.2.23

Choose a tag to compare

@cwasley cwasley released this 09 Nov 23:24

Fixes from testing 0.2.22 in Claude Desktop, plus clearer card search.

Free nights

  • Saying what a free night is worth marks it used, even when the same update_card call or a later one sets enrolled without it. Only skippedCredits naming the night says otherwise. Wallets saved through the old behavior count the night again with no action needed.

Card search

  • An exact card id or name returns just that card ("IHG One Rewards", chase-ihg-one-rewards), so its rates, fee math and recent changes show. Broad searches ("ihg", "gold") still list the family.
  • Searches that find 3 cards or fewer include the published welcome offer, with its end date and fine print.
  • Rules matched only by merchant category codes name the kinds of stores ("caterers, meat markets, candy and nut stores, dairy stores, bakeries and liquor stores") instead of reading out codes.

Data (2026.11.09.4 through 2026.11.09.7, no rates or offers changed)

  • Earlier corrections and welcome-offer notes say what changed for cardholders in plain words, without how the data file stores them; IHG's bills-and-streaming correction is listed once.
  • Welcome offers the weekly check can't read (Bank of America's seven cards, eleven Amex terms pages) were checked by hand and are unchanged. The Atmos business card's page moved to business.bankofamerica.com; Nordstrom's offer eligibility is quoted from the card page's banner.

The hosted connector and earnrate.dev already have these changes.

0.2.22

Choose a tag to compare

@cwasley cwasley released this 09 Nov 21:47

The to-do list now tells you when a card you hold changes, plus the Hilton Aspire's resort credit and a round of wording fixes from testing in Claude Desktop.

Changes to your cards

  • list_wallet and earnrate todo list an issuer's recent changes to a card you hold (fees, rates, credits) with the issuer's page. A welcome-offer change shows only when you're tracking that bonus.
  • earnrate's own recent corrections to your cards share one line. search_cards (and earnrate cards <query>) now shows a card's recent changes, and each card's earnrate.dev page lists them under Recent changes.

Hilton Aspire

  • The $400 Hilton Resort Credit is recorded: up to $200 each half year at participating Hilton Resorts. Name a Hilton resort to count it; a plain "Hilton" doesn't, since only the resorts Hilton lists qualify. It counts in the card's fee math and renewal check.
  • A free night at your own value reads "anniversary free night worth $400 to you".

Clearer answers

  • An answer that uses a statement credit gives the credit's terms (participating resorts, minimum stays).
  • The renewal check for a card held alone names "the best no-fee card (Citi Double Cash)", not a card you might think you hold.
  • Categories the issuer applies itself (Citi Custom Cash, Amex Business Gold) say to set the one you expect, not to pick one.
  • Recorded purchases read "toward its cap on the category you spend the most in each month ... for November 2026"; periods are words, not keys like "2026-11".
  • search_cards says "annual fee not on file" when earnrate has none.

Data (2026.11.09 through 2026.11.09.3)

  • Nordstrom Visa: no foreign transaction fee.
  • Spend-bonus free nights start with "a" ("a Free Night Reward").
  • The weekly source check now requires welcome-offer quotes in the text a page shows, so an old offer left in hidden markup no longer counts.

The hosted connector and earnrate.dev already have these changes.

v0.2.21

Choose a tag to compare

@cwasley cwasley released this 09 Nov 04:13

Clearer answers for people who haven't entered any cards, and a way to answer "is this card worth it?" from earnrate's own math.

Is it worth it?

  • search_cards (and earnrate cards <query>) now gives a card's earning rates and, for a card with an annual fee, the same fee math as its earnrate.dev page: the monthly spending in its bonus categories at which it beats the best no-fee card, with its credits used, and at 1.7¢ a point for Amex and Chase points. It comes with searches that find 3 cards or fewer. Saved point values are used when you have them.
  • Fixed on the card pages: the "if you transfer points" amount was worked out on the wrong spending mix (Amex Gold now $720 a month, Sapphire Preferred $520).

Cards you have to qualify for

  • Answers that rank every card list cards that need a membership (Verizon, Navy Federal, Caltech EFCU, Costco, Sam's Club, REI) apart: "If you have a Verizon wireless or Fios account: Verizon Visa Card, 4%." With the membership saved or given, the card held or named, or a store that implies it (Costco, Sam's Club), they rank as before.

Rent and mortgage

  • "Rent", "mortgage" and "housing" are recognized and answered with a note instead of a ranking: most landlords and lenders don't take cards directly and payment services charge a fee, while the Bilt cards earn up to 1.25X on rent and mortgages paid through Bilt. A year of spending leaves rent out.

Free nights

  • A yearly free night can count at what it's worth to you: update_card with nightValues, or earnrate update <card> --night-value <id>=<dollars>. It replaces the point-cap value in the renewal and fee math, and marks the night used. Hilton Aspire's Annual Free Night Reward is now recorded; with no point cap, it counts only once you give it a value.

Smaller

  • "Phone bill" and "concert tickets" find their categories; Bilt's pick reads "3x category".
  • Freedom Flex's not-yet-announced quarters are mentioned only to people who hold or name it.
  • Pairs in a spending simulation name each interchangeable card once.

The hosted connector and earnrate.dev already have these changes.