pointmaxx-mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,18 +1,10 @@
-# PointMaxx MCP server
+# pointmaxx-mcp
 
-Lets an AI assistant (Claude, or any app that speaks the Model Context Protocol) ask PointMaxx three things:
+Ask your AI assistant which credit card to use, and which cards would earn you the most, with the same math as [pointmaxx.app](https://pointmaxx.app). Compares 53 U.S. credit cards after annual fees, spending caps and the credits you'd actually use.
 
-- **best_card**: which of your cards earns the most at a store or in a category.
-- **compare_cards**: which one, two and three cards would earn the most on your monthly spending, after fees, and how much more that is than your cards.
-- **card_terms**: a card's fee, rates, caps and credits, and when they were last checked; with no card, every card it knows (54, one of them closed to new applicants).
+## Set it up
 
-It uses the site's own engine (`public/engine.js`, `public/cards.json`) and the extension's per-purchase ranking (`extension/pick.js`), so all three give the same answers.
-
-## Privacy
-It runs on your own machine over stdio and makes no network requests. It takes card names and monthly totals by category, never statements or card numbers, and saves nothing.
-
-## Use it with Claude Desktop
-Add this to Claude Desktop's config (Settings, then Developer, then Edit Config), then restart Claude:
+**Claude Desktop:** open Settings, then Developer, then Edit Config, add this, and restart Claude:
 
 ```json
 {
@@ -22,12 +14,28 @@ Add this to Claude Desktop's config (Settings, then Developer, then Edit Config)
 }
 ```
 
-Needs Node 18 or later. Other MCP apps take the same command: `npx -y pointmaxx-mcp`.
+**Any other MCP app:** run `npx -y pointmaxx-mcp` as a stdio server. Needs Node 18 or later.
+
+## What you can ask
+
+| Tool | Ask your assistant something like |
+|---|---|
+| `best_card` | "I have Amex Gold and Citi Double Cash. Which should I use on DoorDash?" |
+| `compare_cards` | "I spend about $500 a month on groceries, $300 on dining and $1,500 on everything else. Which two cards would earn the most? I have a Double Cash." |
+| `card_terms` | "What's the annual fee on the Sapphire Reserve, and what are its credits?" |
+
+Answers include each card's percent back, why it wins, any spending cap, the net value a year after fees, and how much more that is than the cards you already have.
+
+## Privacy
+
+It runs on your own computer and makes no network requests. It only needs card names and rough monthly spending by category: never statements, card numbers or a login. Nothing is saved.
+
+## Good to know
 
-From a copy of this repo instead, use `"command": "node", "args": ["/full/path/to/card-backtest/mcp/server.mjs"]` after running `node mcp/build.mjs`.
+- Estimates from each card's published terms, checked against issuer pages. Not financial advice; check the issuer before you apply.
+- Points are valued at a fixed cents-per-point for each card. Sign-up bonuses are left out.
+- Card terms are built into each release. Run with `npx -y pointmaxx-mcp` to always get the latest.
 
-## Test
-`node mcp/build.mjs && node mcp/server.test.mjs` copies in the engine and card data, then runs it over stdio and checks its answers against the engine.
+For a full backtest on a year of your own statements, read in your browser and never uploaded, try [pointmaxx.app](https://pointmaxx.app).
 
-## Publishing
-`cd mcp && npm publish` (prepack copies the engine and card data into `lib/`). Bump `version` in `mcp/package.json` whenever `public/cards.json` changes, so people get the new terms.
+MIT licensed. Card data includes [CardPin](lib/CARDPIN-LICENSE.txt) (MIT).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pointmaxx-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "PointMaxx for AI assistants: which of your credit cards to use, which cards to get on your spending, and any card's terms. Runs locally; nothing leaves your machine.",
   "type": "module",
   "bin": { "pointmaxx-mcp": "server.mjs" },

package/server.mjs

@@ -15,7 +15,7 @@ require(path.join(LIB, 'engine.cjs'));
 const E = globalThis.Engine;
 await import(pathToFileURL(path.join(LIB, 'pick.cjs')).href);
 const STORES = require(path.join(LIB, 'stores.json'));
-const VERSION = '0.1.0', VERSIONS = ['2025-06-18', '2025-03-26', '2024-11-05'];
+const VERSION = '0.1.1', VERSIONS = ['2025-06-18', '2025-03-26', '2024-11-05'];
 const NOTE = 'Estimates from each card\'s published terms, not financial advice. Check the issuer before applying.';
 const CATS = Object.keys(E.CAT_LABEL);