pointmaxx-mcp 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PointMaxx
+
+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/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# PointMaxx MCP server
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Lets an AI assistant (Claude, or any app that speaks the Model Context Protocol) ask PointMaxx three things:
+
+- **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).
+
+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:
+
+```json
+{
+  "mcpServers": {
+    "pointmaxx": { "command": "npx", "args": ["-y", "pointmaxx-mcp"] }
+  }
+}
+```
+
+Needs Node 18 or later. Other MCP apps take the same command: `npx -y pointmaxx-mcp`.
+
+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`.
+
+## 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.
+
+## 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.

package/lib/CARDPIN-LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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.