Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.

KiasuMiles

"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 one or the 1.2 mpd one.

KiasuMiles solves this. It connects to your AI agent, learns your exact cards, and tells you which one earns the most miles at any Singapore merchant — based on the actual MCC your card posts under, not generic blog listicles.

Tell it which cards you carry. Once. It remembers. From then on, just ask.

No hosting. No API keys. Works offline.


Why it's different

Most miles guides tell you "use Card X for dining, Card Y for online shopping." Useful — until your wallet has 6 cards and you're standing at the checkout trying to remember which one applies here.

KiasuMiles knows your wallet specifically. It filters out every card you don't own, factors in monthly caps, and if you carry Amaze, it automatically nets out the fee and calculates the combo earn rate.

You ask. It answers. One card. No second-guessing.


How it works

  1. Ask your agent to install KiasuMiles
  2. Tell your agent which cards you carry — once, in plain English
  3. At any merchant, just ask: "which card?"

Your agent returns your best card, the earn rate, and the monthly cap — from your wallet only.


Setup

Easiest: Tell your agent to install it for you:

"Install kiasumiles-mcp for me"

Your agent handles the rest automatically.

Or install directly:

pip3 install kiasumiles-mcp && kiasumiles-setup

The setup script auto-configures Claude Desktop and Claude Code if installed.

Supported agents

  • Claude Desktop
  • Claude Code (CLI)
  • OpenClaw
  • Hermes — after install, run hermes mcp list and hermes mcp test kiasumiles to verify. If KiasuMiles tools still don't appear after /new, restart the gateway with hermes gateway restart, then start a fresh chat.
  • Any agent with pip access

Set up your card wallet

"Use KiasuMiles to set up my wallet — show me what cards are available, then ask me which ones I have"

Your agent shows you all supported cards, asks which ones you carry, and saves your wallet. You only do this once. To check what's saved anytime:

"Use KiasuMiles to show me my wallet"


Daily use

At a merchant, in the car, at checkout — just ask:

  • "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 surfaces your best option with the earn rate and cap. If you have Amaze, the combo math is already done.


Updating your wallet

"Update my KiasuMiles wallet — add OCBC 90N Mastercard, remove UOB PPV."

Plain English. Your agent handles the rest.


Tools

Tool What it does
kiasumiles_lookup Best card for a merchant — MCC, earn rate, cap
kiasumiles_configure Save your card wallet
kiasumiles_get_wallet See your currently saved cards
kiasumiles_list_cards See all 50+ supported cards

Supported cards

50+ Singapore credit cards in the database — but KiasuMiles only ever shows you results for cards you actually carry. Set up your wallet once; everything else is filtered out.

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

"Show me all KiasuMiles cards" — ask your agent for the full list.


Data

Merchant MCC data is community-verified and updated regularly. Card earn rates and caps are sourced from publicly available bank T&Cs.

Confidence levels are included in results — if a merchant has limited data points, you'll know.


Verify installation

"Check if you have access to KiasuMiles tools"

Your agent will confirm it can see kiasumiles_lookup and the other tools.


Feedback

If a card recommendation looks wrong (wrong card, stale earn rate, missing merchant), send the details to @kiasumilesbot on Telegram. Include the merchant name and which card was suggested. Every report is reviewed.


About

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

MIT License

Metadata

Release files for kiasumiles-mcp 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kiasumiles-mcp 0.1.3
File Size Uploaded Provenance Actions
kiasumiles_mcp-0.1.3.tar.gz 484.7 kB Without provenance Details for kiasumiles_mcp-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kiasumiles-mcp 0.1.3
File Interpreter ABI Platform Actions
kiasumiles_mcp-0.1.3-py3-none-any.whl Python 3 none any Details for kiasumiles_mcp-0.1.3-py3-none-any.whl

Total release size: 536.9 kB

Release files / kiasumiles_mcp-0.1.3.tar.gz

Download URL kiasumiles_mcp-0.1.3.tar.gz
Size 484.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ceaf20a2ace14b7746c345d28403f29105c3d93e3037ea6eb27f08c6cc2dba05
BLAKE2b-256 checksum
How to use checksums
0a735fb6af0c0e6c78f598b3b908ce78c0a2c42bcb00906f571c3fe29cdd641c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Release files / kiasumiles_mcp-0.1.3-py3-none-any.whl

Download URL kiasumiles_mcp-0.1.3-py3-none-any.whl
Size 52.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e831503b1f9eb074349c6afdf9b89c67ea6cd8ac5794d8a7951f6501c8b6875c
BLAKE2b-256 checksum
How to use checksums
fea782dc926a47a3f6f7a69c8c987d49bd09465ded97286901302c623bb05da4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Security for kiasumiles-mcp 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page