MCP App Store
by KeenEthics
earnrate icon

earnrate MCP Server for ChatGPT

By Collin Wasley

Overview

earnrate tells you which credit card earns the most for a purchase, from each issuer's own terms. Ask about a store, a kind of place or an amount, like "which card at Whole Foods for $80?", and it names the card, the rate and the reason, with the rule it used and what it assumed. It works with no setup. Without your cards, it answers from all 69 U.S. credit cards it knows, from 11 issuers. Name your cards for an answer from just those, or save them to an anonymous wallet so earnrate can track spending caps, quarterly bonus categories and activations, welcome bonuses and yearly spend bonuses. It can also make a cheat sheet of which card to use for everyday spending, list what to do with your cards this quarter, compare welcome offers, and run a year of spending through every card and pair of cards. The saved wallet has no email or name: you get a recovery code, which you type only on earnrate's own page. earnrate never asks for card numbers. It doesn't apply for cards, make payments, or show ads or affiliate links, and nothing but the issuer's terms and your own cards and settings decides a ranking. Limitations: U.S. personal and small-business credit cards only. Card terms are checked against the issuers' pages every week, but issuers can change them at any time, so check the issuer's page before relying on an answer for a large purchase.

How to connect

  1. ChatGPT: Open the earnrate listing in the ChatGPT app directory and choose Connect. ChatGPT listing earnrate exposes 19 tools here.

Tools

add_card

ChatGPT
Adds a card the user holds to their wallet by its id from search_cards, creating the wallet if there isn't one. The reply says what the card still needs (category picks, memberships, activations); ask the user about those. Stores only the card's product id and settings, never card numbers. It uses the user's hosted earnrate wallet, not a wallet file on their computer.

best_card_for_purchase

ChatGPT
Which credit card earns the most rewards for a purchase, and why. With no cards given and no saved wallet, it ranks every card earnrate knows (in allCards): a complete answer for anyone. With cards named in the conversation (cards) or a saved wallet, it picks the best of the user's own: decision.cardId is the pick and decision.checkoutLabel is how the card appears at checkout, with every usable card ranked with reasons, cards the merchant won't take, assumptions, warnings, and when a different point valuation would change the pick. For a business earnrate may not know, like a local restaurant, pass category when you can tell what kind of business it is. When the user is paying outside the U.S. or in another currency, pass country: abroad, each card is ranked after its foreign transaction fee. Never needs or returns card numbers.

best_cards_for

ChatGPT
Ranks every card earnrate knows that takes new applicants, not only the user's, for one purchase or category, each set up at its best (the right category pick, activated, cap unused), with its annual fee and what earning the rate takes. Use it for questions like "what's the best card for groceries?" or "which card should I get for Amazon?". It needs no wallet. For which of the user's own cards to use, call best_card_for_purchase instead. Mention the annual fee and any conditions alongside each card.

cheat_sheet

ChatGPT
The card to use for each everyday kind of purchase right now: groceries, dining, gas, Amazon, Costco, travel, streaming, drugstores and everything else. With no cards given and no saved wallet, it picks from every card earnrate knows (scope: all cards, each row noting the card's fee and conditions). With cards named in the conversation or a saved wallet, it picks from the user's own cards, with caps, picks and activations as they are. The kind, noAnnualFee, business and issuer filters apply only when it picks from every card. For one specific store, call best_card_for_purchase instead. Pass on the notes.

compare_welcome_offers

ChatGPT
Ranks the public welcome (sign-up) offers on cards the user doesn't have by first-year value: the bonus at the user's point values minus the first year's annual fee and any membership the card needs that the user doesn't have. Offers the issuer rules out because of a card in the user's wallet are marked likely not eligible and listed last. Use it when the user asks which new card to get or which has the best sign-up bonus. It covers only the cards earnrate knows, offers vary by person, and each offer's note gives the issuer's eligibility rules; pass those caveats on. It doesn't account for what a card would earn on the user's spending.

delete_wallet

ChatGPT
Deletes the saved wallet and its recovery code now and for good, and signs out every app connected to it, this one included. earnrate.dev and the earnrate command line keep their own wallets and aren't affected. Only when the user asks to delete it: show it with list_wallet, offer export_wallet, and pass confirm, cards and saved only after the user confirms. It refuses if the wallet no longer holds what list_wallet showed, so a retried call can't delete a different wallet.

export_wallet

ChatGPT
The saved wallet as a wallet.yaml file the earnrate command line and earnrate.dev can import: card ids, picks, activations, memberships, point values, cap usage, bonus progress and yearly spending toward spend bonuses. Never card numbers.

import_wallet

ChatGPT
Replaces the saved wallet with a wallet.yaml from the earnrate command line or earnrate.dev, when the user pastes or attaches one. Wallet files only: never statements or card numbers. If anything is already saved (cards, memberships or point values), it refuses unless replace is true: confirm with the user first.

list_wallet

ChatGPT
Starts with a to-do list for the user's cards right now (bonuses to activate and their deadlines, categories to pick or confirm, caps nearly used up, welcome bonuses to finish and the weekly pace, yearly spend bonuses at least 75% of the way); use it when the user asks what to do with their cards this quarter or what they're forgetting. Then lists the user's cards: checkout label, network, rewards currency and its value, spending caps with how much is left this period, chosen bonus categories (and whether they're current), welcome-bonus progress, progress toward yearly spend bonuses, which stores a store card works at, when each card's data was last verified, the point values the user saved, and (for the hosted wallet) when it was started. It uses the user's hosted earnrate wallet, not a wallet file on their computer.

record_purchase

ChatGPT
Records a purchase the user has already made, so spending caps, welcome-bonus progress and yearly spend milestones stay accurate for future recommendations. It updates the user's saved wallet. Only call it after the purchase has happened, and only once per purchase: calling it twice counts the spend twice. Purchases with no cap, no open welcome bonus and no spend milestone are acknowledged and nothing is written. For a merchant earnrate doesn't recognize it asks for category first, so caps aren't missed. It uses the user's hosted earnrate wallet, not a wallet file on their computer.

remove_card

ChatGPT
Removes a card from the wallet, with its tracked cap usage, bonus progress and yearly spending. Memberships and point values stay, even when the last card goes. Only when the user says they no longer have it or don't want it considered. It uses the user's hosted earnrate wallet, not a wallet file on their computer.

resolve_merchant

ChatGPT
Shows how earnrate identifies a merchant: its spend category, likely MCC, which card networks it takes, confidence, and whether that came from curated data, Claude, or nowhere. Use it to explain or double-check a recommendation.

search_cards

ChatGPT
Finds credit cards in earnrate's catalog by name or issuer, e.g. "sapphire", "amex gold" or "bofa". Returns each card's id (for add_card), network, annual fee, whether it's already in the wallet, and what it needs set up: category picks and their options, memberships, activations. Leave the query out to list every card. US cards only.

set_card_history

ChatGPT
Saves the cards the user used to have and no longer holds, with the months they know (opened, closed, when the welcome bonus posted). compare_welcome_offers then checks each issuer's published repeat-bonus rule against them and the saved cards: "Chase says you may not get this bonus again", or "Not before March 2027". Only the card id is needed; ask for months only when the issuer's rule counts from one. Replaces the whole list, so call list_wallet first and include the ones to keep. Only rules issuers publish are checked; never assume one (5/24 is skippedIssuers on set_memberships). Never suggest closing a card to earn a bonus again. It uses the user's hosted earnrate wallet, not a wallet file on their computer.

set_memberships

ChatGPT
Sets the memberships that unlock some cards' rates, such as amazon-prime for Prime Visa's 5% or a Bank of America Preferred Rewards tier, and costco for a Costco membership (so spending answers don't count its cost against Costco Anywhere). Replaces the whole list, so include the ones to keep. It saves them even with no cards saved, and every answer then uses them. It uses the user's hosted earnrate wallet, not a wallet file on their computer.

set_point_values

ChatGPT
Saves what the user's points are worth to them, in cents per point, in their saved wallet; every answer then compares cards at those values unless a valuation profile is asked for. No saved cards are needed. Use it when the user says what their points are worth ("I value Chase points at 1.5¢") or that they transfer points to airlines and hotels (profile points-heavy). Values change only the currencies given; null goes back to earnrate's default. Currencies by id: cash (Cash back), MR (Amex Membership Rewards), UR (Chase Ultimate Rewards), sofi-rewards (SoFi Member Rewards), best-buy-rewards (My Best Buy rewards), C1 (Capital One miles), TYP (Citi ThankYou points), WFR (Wells Fargo Rewards), BILT (Bilt points), united-miles (United MileagePlus miles), aadvantage-miles (American Airlines AAdvantage miles), southwest-rapid-rewards (Southwest Rapid Rewards points), aeroplan (Aeroplan points), atmos-points (Atmos Rewards points), ihg-points (IHG One Rewards points), delta-skymiles (Delta SkyMiles), hilton-honors (Hilton Honors points), marriott-bonvoy (Marriott Bonvoy points), kohls-rewards (Kohl's Rewards), nordy-club (Nordy Club points). It uses the user's hosted earnrate wallet, not a wallet file on their computer.

simulate_spending

ChatGPT
Spends monthly amounts for a year across every card earnrate knows, and ranks single cards and two-card pairs by rewards minus annual fees, and minus a membership a card needs (a Costco membership) unless the user has it or spends at Costco. Spending is optional: without it, typical U.S. household amounts are used and the answer says so. With cards (named in the conversation) or compareToWallet (the saved wallet), it ranks the cards that would add the most to those cards instead. Use it for "which card fits my spending?" or "is it worth adding a card?". It leaves out welcome bonuses.

switch_wallet

ChatGPT
Disconnects this app from its saved wallet so the user can connect a different one with its recovery code, or start a new one, on earnrate's page. Nothing is deleted. It also signs out anyone else connected to this wallet through the same app (another account the recovery code was shared with): say so before calling it. Use it when the user wants another wallet. Never ask for the recovery code in the conversation.

update_card

ChatGPT
Changes settings on a card already in the wallet: its category picks for this period, checkout label, anniversary, activated categories, cap spending so far (capSpent), spending this year toward its spend milestones (milestoneSpent) or a welcome bonus to track. Picks replace the saved ones in each choice group you set (other groups are kept) for the current period. Use it when the user picks new categories, such as each quarter on U.S. Bank Cash+. It uses the user's hosted earnrate wallet, not a wallet file on their computer.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/earnrate"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/earnrate)