Documentation

Build on Finstracker.

Pull your card data over REST, or hand it to an LLM through MCP. Same JWT works for both, so there's nothing new to learn on the auth side.

For developers & tinkerers

What can I build?

  • "What card should I use at Target right now?" Hook MCP into Claude and ask. Finstracker checks your active Chase/Amex/BoA offers and ranks your wallet.
  • Monthly perk reminders in your own tools. Poll /api/perks?status=open from a cron job and pipe results to Slack, email, or a custom dashboard.
  • Bring-your-own analytics. Export every transaction via /api/transactions and run your own charts. No paywall on read endpoints during trial.
  • Custom card-onboarding flows. POST a card with cardKey and let the catalog auto-seed perks and offers, so your user never sees an empty state.

Authentication

Both surfaces use the same JWT bearer token. POST to /api/auth/login with { username, password }, read data.token, then send Authorization: Bearer <token> on every request. Tokens are valid for 7 days. One token, both APIs.

Status

The REST API powers the production web app and is considered stable. The MCP server is in beta, so tool input schemas and response shapes may still change as I learn how people actually use it. Anything that breaks will be noted in the changelog.