KiasuMiles

View the live landing page and 60s demo

"Which card do I use again?"

If you're in the miles game, you've asked this at least once - standing at the cashier, not quite sure if this is the 4 mpd card or the 1.2 mpd one.

KiasuMiles connects to your AI agent, remembers the cards you carry, and tells you which card earns the most miles at the merchant in front of you. Card rules and merchant data stay current through the hosted KiasuMiles service.

---

Why this exists

Miles guides tell you "Card X for dining, Card Y for online shopping". That works until your wallet has six cards and the merchant in front of you doesn't fit the chart.

KiasuMiles ranks against the cards you actually hold. Your agent remembers your selected card stack, checks it against the latest KiasuMiles rules, and returns one usable answer with the caveats attached. No second guessing at the counter.

---

Get started

Copy and paste this into your agent:

Install KiasuMiles MCP for me: https://kiasumiles.space/mcp

Use KiasuMiles. First help me set up my card stack. Ask me which banks I have cards with, show me the matching supported cards, then remember my selected cards for future KiasuMiles lookups.

You only do this once. After that, ask KiasuMiles which card to use whenever you are paying.

Everyday prompts

After setup, ask checkout questions like:

What card should I use at NTUC FairPrice?

I'm paying for Grab in the app. Which card?

Booking Singapore Airlines online. Which card gets the most miles?

KiasuMiles returns the best card from your card stack, the miles per dollar, the cap, and any caveats you should know before paying.

Check or update your cards

Use plain English:

Show me my KiasuMiles card stack.

Add OCBC 90N to my KiasuMiles card stack.

Remove UOB PPV from my KiasuMiles card stack.

Review my KiasuMiles card stack and tell me which categories are weak.

You do not need to know card IDs or technical setup details. The agent handles them.

---

Hosted MCP Details

For agents and developers, KiasuMiles exposes these hosted MCP tools:

Tool	What it does
kiasumiles_lookup	Best card for a merchant, ranked from the cards supplied by the client
kiasumiles_list_cards	Supported cards and their stable internal IDs
kiasumiles_recommend_stack	Weak categories in the cards supplied by the client
kiasumiles_data_version	Current card and merchant data version
kiasumiles_agent_guide	Integration and display guidance for agents

The hosted server deliberately has no wallet setup or wallet read tools. Wallet storage belongs in the agent, app, or user-controlled client. Hosted recommendations are scoped to the card IDs supplied in the current request; if no cards are supplied, the tools ask for a card stack instead of ranking the whole database.

For ChatGPT Actions, the hosted server also exposes a public REST adapter:

Route	Purpose
GET /api/chatgpt/openapi.json	OpenAPI schema for a private or public GPT Action
GET /api/chatgpt/cards?bank=UOB	Card names by bank, without internal IDs
POST /api/chatgpt/lookup	Stateless merchant lookup using cards supplied in the request
POST /api/chatgpt/recommend-stack	Weak-category review using cards supplied in the request

The Action adapter accepts card names, resolves them internally, and strips raw card IDs and MCC fields from public JSON responses.

Example lookup shape:

{
  "merchant": "NTUC FairPrice",
  "cards": ["uob_ppv", "citi_rewards_mc"],
  "channel": "mobile_contactless"
}

Lookup responses include reason_summary, reason_codes, and gotchas, so the agent can explain why a card wins and warn about traps: wrong payment channel, partner-only bonuses, minimum spend you haven't hit.

The endpoint is rate limited per IP (30 requests a minute by default). Normal agent use never gets near it.

Try it

curl -i -X POST https://kiasumiles.space/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl-smoke","version":"1.0"}}}'

---

Supported agents

• ChatGPT
• Codex
• Claude Desktop
• Claude Code
• OpenClaw
• Hermes
• Any MCP-capable agent

---

For Maintainers

The hosted app reads card rules and merchant mappings from the configured production backend. The public package ships small demo CSVs for development and tests.

Environment variables (set in Vercel for hosted deployments):

• KIASUMILES_SUPABASE_URL
• KIASUMILES_SUPABASE_SERVICE_ROLE_KEY
• KIASUMILES_SUPABASE_CARDS_TABLE (optional, default card_rules)
• KIASUMILES_SUPABASE_MERCHANTS_TABLE (optional, default merchant_mcc)
• KIASUMILES_DATA_BACKEND (optional: auto or supabase)
• KIASUMILES_RATE_LIMIT_REQUESTS (optional, default 30; 0 disables)
• KIASUMILES_RATE_LIMIT_WINDOW_SECONDS (optional, default 60)

Backend selection:

• auto: Supabase when credentials are present, else bundled demo CSVs
• supabase: require Supabase, fail loudly if unreachable

The table schema lives at supabase/schema.sql. Both kiasumiles_data_version and /health report data_backend, so you can confirm whether production is reading from supabase or demo_csv.

---

Daily use

At checkout, in the car, mid-booking, ask your agent:

• "What card at NTUC FairPrice?"
• "Best card for Grab contactless?"
• "I'm at Shell. Which card?"
• "Booking flights on Singapore Airlines, which card?"
• "Which card at Shake Shack, paying online?"

KiasuMiles picks from your supplied stack and shows the earn rate and cap. If Amaze is in the stack, the combo math is already done.

---

Supported cards

40+ Singapore credit cards in the database. Recommendations only ever draw from the cards you supply in the request.

HSBC Revolution · UOB PPV · UOB Visa Signature · UOB PRVI Miles · UOB Lady's · KrisFlyer UOB · DBS Altitude · DBS yuu · DBS Woman's World · DBS Vantage · Citi Rewards · Citi PremierMiles · Citi Prestige · OCBC 90N · OCBC Rewards · OCBC VOYAGE · Maybank Horizon · Maybank World · Standard Chartered Journey · Standard Chartered Visa Infinite · BOC Elite Miles · Amex KrisFlyer · Amex KrisFlyer Ascend · Amex HighFlyer · Amaze combos · and more

Ask your agent to "show me all KiasuMiles cards" for the full list.

---

Data

Merchant MCC data comes from community reports and gets re-verified on a rolling basis. Card earn rates and caps come from published bank T&Cs. Results carry a confidence level, so if a merchant only has a few data points behind it, you'll know.

---

Feedback

If a recommendation looks wrong (wrong card, stale earn rate, missing merchant), message @kiasumilesbot on Telegram with the merchant name and the card that was suggested. Every report gets read.

---

Changelog

See CHANGELOG.md.

---

About

KiasuMiles is built by Hosan, founder of The AI Burrow, Singapore's applied AI collective for teams and builders who want to move past the hype and actually deploy.

• theaiburrow.xyz
• Telegram: t.me/theaiburrow
• Email: [email protected]

MIT License