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 / -a N (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