pointmaxx-mcp 0.1.0 → 0.1.2

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,31 @@ 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
+
+- 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.
 
-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`.
+For a full backtest on a year of your own statements, read in your browser and never uploaded, try [pointmaxx.app](https://pointmaxx.app).
 
-## 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.
+MIT licensed. Card data includes [CardPin](lib/CARDPIN-LICENSE.txt) (MIT).
 
-## 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.
+## Source
+This repo is the published package: `server.mjs` plus the engine and card data in `lib/`, copied from PointMaxx's main codebase at each release. Run `npm test` to check it.

package/package.json

@@ -1,17 +1,36 @@
 {
   "name": "pointmaxx-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "mcpName": "io.github.trypointmaxx/pointmaxx-mcp",
   "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" },
-  "files": ["server.mjs", "lib/", "README.md", "LICENSE"],
-  "engines": { "node": ">=18" },
-  "keywords": ["mcp", "model-context-protocol", "credit-cards", "rewards", "cash-back", "points"],
+  "bin": {
+    "pointmaxx-mcp": "server.mjs"
+  },
+  "files": [
+    "server.mjs",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "credit-cards",
+    "rewards",
+    "cash-back",
+    "points"
+  ],
   "homepage": "https://pointmaxx.app",
   "license": "MIT",
   "scripts": {
-    "build": "node build.mjs",
-    "prepack": "node build.mjs",
-    "test": "node build.mjs && node server.test.mjs"
+    "test": "node server.test.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/trypointmaxx/pointmaxx-mcp"
   }
 }

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.2', 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);