CardPointers CLI
Query your CardPointers wallet — cards, offers, recommendations — from the terminal.
Setup
- Config:
~/.cardpointers/config(JWT token, auto-created on login) - Requires:
curl,jq,bash - Auth: Run
cardpointers loginto authenticate (email/password or browser-based Apple/Google/passkey)
Commands
recommend — Best card for a purchase
cardpointers recommend groceries
cardpointers recommend "gas stations"
cardpointers recommend --merchant amazon
cardpointers recommend -m "whole foods" --amount 150
cardpointers recommend gas -p all # best gas card across all profiles
cards — List wallet cards
cardpointers cards # approved cards (default)
cardpointers cards --status all # all statuses
cardpointers cards --bank chase # filter by bank
cardpointers cards -b amex -s all -l 5 # combine filters + limit
offers — List and filter offers
cardpointers offers # active offers
cardpointers offers -s redeemed # redeemed offers
cardpointers offers --expiring # expiring within 7 days
cardpointers offers -e 14 # expiring within 14 days
cardpointers offers --bank amex # filter by bank
cardpointers offers --card "gold" # filter by card name
cardpointers offers --category dining # filter by category
cardpointers offers --type personal # personal offers only
cardpointers offers --favorite # favorited offers only
cardpointers offers --sort value --limit 10 # top 10 by value
search — Search offers by keyword
cardpointers search "whole foods"
cardpointers search "streaming" --favorite
cardpointers search "gas" --limit 5
profiles — List linked profiles
cardpointers profiles
Utility
cardpointers status # account info + connection test
cardpointers ping # test MCP connection
cardpointers tools # list available MCP tools
cardpointers login # authenticate
cardpointers logout # clear saved token
cardpointers --version # print version
Global Options
All data commands accept these flags:
| Flag | Description |
|---|---|
--profile, -p | Query by profile: number (-p 2), name (-p caroline), or all/any |
--limit, -l | Cap number of results |
--json, -j | Raw JSON output (for scripting / AI agents) |
Environment Variables
| Variable | Description |
|---|---|
CARDPOINTERS_API | Override API base URL (default: https://mcp.cardpointers.com) |
CARDPOINTERS_DEBUG | Set to 1 for verbose output |
NO_COLOR | Disable ANSI colors |
Reference
- Card statuses: approved, applied, denied, closed, all
- Offer statuses: active, snoozed, redeemed, expired, expiring_soon, all
- Offer bank filter (enum): amex, chase, citi, boa, usbank, wellsfargo
- Card bank filter: freeform text (partial match)
- Offer sort options: expiring, value, card
- Cards include
approval_date(YYYY-MM-DD)
Common Use Cases
- "What card should I use at Costco?" →
recommend -m costco - "Show my Amex cards" →
cards -b amex - "Offers expiring this week?" →
offers -e 7 - "Any Whole Foods offers?" →
search "whole foods" - "Best dining card across all profiles?" →
recommend dining -p all - "Top 5 offers by value" →
offers --sort value -l 5 - "Show redeemed offers as JSON" →
offers -s redeemed -j