AI Agent Integration

CheckMCC + OpenClaw

Give your AI agents instant access to MCC code lookups, merchant searches, and Singapore credit card recommendations.

What is OpenClaw?

OpenClaw is an open-source framework that lets AI agents interact with external services through structured skills. A skill is a small package that defines commands an agent can run — like looking up MCC codes on CheckMCC.

Plug & Play

Install skills into any OpenClaw-compatible agent

Structured Data

Agents get typed responses, not raw HTML

Zero Config

No API keys needed — uses public endpoints

What Your Agent Can Do

Lookup by Domain

Check a store's MCC code by its website domain (e.g. fairprice.com.sg)

Search Merchants

Fuzzy search for stores by name — returns MCC, category, and country

Card Recommendations

Get eligible Singapore credit cards for any MCC code with MPD rates and caps

MCC Code Reference

Look up any MCC code by number or search by category keyword

How to Install

Install the CheckMCC skill

Add the skill to your OpenClaw workspace:

bash

openclaw skill install check-mcc

Run your first lookup

Look up a merchant by domain:

bash

scripts/check-mcc.sh lookup fairprice.com.sg

Get card recommendations

See which Singapore credit cards earn bonuses for a given MCC:

bash

scripts/check-mcc.sh cards 5812

API Reference

Endpoint	Method	Description
`/api/store-by-domain?domain=X`	GET	Look up a merchant by website domain. Returns MCC, category, country, and eligible credit cards.
`/api/store/search?q=X`	GET	Search stores by name. Returns matching merchants with MCC and category.
`/api/mcc`	GET	Get all ~300 MCC codes with descriptions.
`/api/mcc/codes`	GET	Get MCC code list only (lighter response).

Example Usage

Domain Lookup

Returns the full merchant profile including eligible credit cards:

bash

curl "https://check-mcc.vercel.app/api/store-by-domain?domain=shopee.sg"

Response

json

{
  "Store": "Shopee",
  "MCC": "5399",
  "Category": "Miscellaneous General Merchandise",
  "Country": "Singapore",
  "eligibleCards": [
    {
      "name": "UOB Preferred Platinum Visa",
      "eligible": true,
      "mpd": "4 MPD",
      "spendCap": "Cap at $1,000 a month"
    },
    {
      "name": "DBS Woman's Card",
      "eligible": true,
      "mpd": "4 MPD",
      "spendCap": "Cap at $1,000 a month"
    }
  ]
}

Search Merchants

Fuzzy search by store name:

bash

curl "https://check-mcc.vercel.app/api/store/search?q=cold+storage"

Look Up MCC Code

By code number or keyword:

bash

# By number
scripts/check-mcc.sh mcc 5812
# Output: Eating Places and Restaurants

# By keyword
scripts/check-mcc.sh mcc restaurant

Common MCC Codes

MCC Code	Category
`5812`	Eating Places and Restaurants
`5814`	Fast Food Restaurants
`5411`	Grocery Stores, Supermarkets
`5541`	Service Stations (Petrol)
`4121`	Taxicabs and Limousines
`5999`	Miscellaneous Retail
`6010`	Financial Institutions
`6051`	Non-financial Institutions

Start Building with CheckMCC

Install the skill and give your AI agents instant access to MCC code data and Singapore credit card recommendations.

Search Merchants Browse All MCC Codes

💬Contact me via Telegram