pointmaxx-mcp 0.0.0-stage → 0.1.1

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,41 @@
-# Temporary Holding Version
+# pointmaxx-mcp
 
-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.
+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.
+
+## Set it up
+
+**Claude Desktop:** open Settings, then Developer, then Edit Config, add this, and restart Claude:
+
+```json
+{
+  "mcpServers": {
+    "pointmaxx": { "command": "npx", "args": ["-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.
+
+For a full backtest on a year of your own statements, read in your browser and never uploaded, try [pointmaxx.app](https://pointmaxx.app).
+
+MIT licensed. Card data includes [CardPin](lib/CARDPIN-LICENSE.txt) (MIT).

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.