README.md
March 2, 2026 · View on GitHub
💳 CardPointers CLI
Your credit card rewards, right in your terminal.
CardPointers CLI lets you manage your CardPointers wallet from the command line — get card recommendations, browse your offers, search for deals, and more. Powered by the CardPointers MCP API.
Requires a CardPointers+ subscription.
Install
Choose your preferred method:
Homebrew (macOS/Linux)
brew tap cardpointers/tap
brew install cardpointers
npm
npm install -g @cardpointers/cli
Quick install script
curl -fsSL https://raw.githubusercontent.com/cardpointers/cli/main/install.sh | bash
Installs to ~/.local/bin by default (or XDG_BIN_HOME if set). Override with:
curl -fsSL https://raw.githubusercontent.com/cardpointers/cli/main/install.sh | bash -s -- --bin-dir ~/bin
To install to /usr/local/bin (may require sudo):
curl -fsSL https://raw.githubusercontent.com/cardpointers/cli/main/install.sh | bash -s -- --system
Manual download
curl -fsSL https://github.com/cardpointers/cli/releases/latest/download/cardpointers -o cardpointers
chmod +x cardpointers
mkdir -p ~/.local/bin
mv cardpointers ~/.local/bin/
Quick start
1. Log in
cardpointers login
Sign in with email/password, or use the browser flow for Apple, Google, or passkey authentication.
2. Get card recommendations
# Best card for a category
cardpointers recommend supermarket
# Best card for a specific merchant
cardpointers recommend --merchant "whole foods"
# Include estimated spend for value calculation
cardpointers recommend restaurant --amount 75
3. View your cards
# Show approved cards
cardpointers cards
# Filter by bank
cardpointers cards --bank chase
# Show all cards (including closed/denied)
cardpointers cards --status all
# Limit results
cardpointers cards --limit 5
# Recently added cards (last 30 days)
cardpointers cards --added 30
# Sort cards
cardpointers cards --sort added
Cards supports --added / -a N and --sort / -r (added, name, bank).
Profiles
Use --profile / -p to target a specific profile by number, name, or across all profiles:
cardpointers cards -p 2 # cards from profile 2
cardpointers cards -p caroline # cards from profile "Caroline"
cardpointers offers -p all # offers from all profiles
cardpointers recommend gas -p any # best gas card across all profiles
4. Browse your offers
# Active offers
cardpointers offers
# Expiring soon (within 7 days)
cardpointers offers --expiring
# Filter by bank or card
cardpointers offers --bank amex
cardpointers offers --card "gold"
# Only favorites
cardpointers offers --favorite
# Sort and limit offers
cardpointers offers --sort value --limit 10
# New offers this week
cardpointers offers --added 7 --sort added
Offers supports --added / -a N and --sort added.
5. Search offers
cardpointers search "streaming"
cardpointers search "whole foods" --favorite
cardpointers search "gas" --limit 5
# Search with offer filters
cardpointers search "dell" --status active --bank amex
Search supports the same filters as offers:
--status/-s(active default, snoozed, redeemed, expired, all)--expiring/-e[days] (expiring within N days, default 7)--card/-c(filter by card name)--category/-y(filter by category)--type/-t(standard/personal)--bank/-b(amex, chase, citi, boa, usbank, wellsfargo)--sort/-r(expiring, value, card, added)--added/-aN (added within last N days)
Common Use Cases
- New offers this week? →
offers --added 7 --sort added - Recently added cards? →
cards --added 30
Global options
cardpointers --version
NO_COLOR=1 cardpointers help
JSON output
Add --json (or -j) to any data command to print raw JSON instead of the formatted output:
cardpointers cards --json
cardpointers offers -j
cardpointers recommend restaurant -j
All commands
| Command | Description |
|---|---|
login | Authenticate (email/password or browser OAuth) |
logout | Clear saved credentials |
status | Show account info and connection status |
recommend <category> | Get best card for a purchase category |
cards | List your wallet cards |
offers | List your active offers |
search <query> | Search offers by keyword |
ping | Test API connection |
tools | List available MCP tools |
version | Show CLI version |
Run cardpointers help or cardpointers <command> --help for full option details.
Configuration
| Item | Location |
|---|---|
| Auth token | ~/.cardpointers/config |
| User info | ~/.cardpointers/user.json |
Override the API endpoint with:
export CARDPOINTERS_API=https://mcp.cardpointers.com
Disable ANSI colors in output with:
export NO_COLOR=1
Requirements
- bash (macOS/Linux — Windows via WSL)
- curl
- jq
What is CardPointers?
CardPointers helps you maximize your credit card rewards by telling you which card to use for every purchase. Available on iOS, Android, and as a browser extension for Chrome, Firefox, Safari, and Edge.
The CLI brings your wallet to the terminal — perfect for quick lookups, scripting, and AI agent integrations via the MCP protocol.
MCP integration
CardPointers CLI talks to the same MCP (Model Context Protocol) server that powers integrations with Claude, ChatGPT, and other AI assistants. You can use the CLI as a standalone tool or as part of an AI agent workflow.
Contributing
Issues and pull requests are welcome! Please open an issue first to discuss what you'd like to change.
License
BSL 1.1 © CardPointers