MCC Explorer

API & Database

API DocsMCP
MCC Explorer
Best card by MCCExploreBlogGuidesPricingAPI DocsContactPrivacyTerms

© 2026 MCC Explorer

    MCC Explorer

    API & Database

    API DocsMCP
    NewHosted MCP server for Claude, Cursor & agents→

    The merchant category code API for every transaction.

    Resolve any merchant or card-statement descriptor to its MCC, with aliases, regions and a cited source. Query it over REST, or hand it to your AI assistant through MCP.

    Get a free API keyRead the docs

    100 requests/month free · no card required · looking for the best card?

    zsh — lookup

    A cURL request to GET /api/v1/lookup with merchant=STARBUCKS returns MCC 5814, Fast Food Restaurants, as the primary mapping with aliases and regions.

    $

    Database coverage

    MCC codes
    1,087
    with categories & descriptions
    Merchants
    12,504
    with aliases & descriptors
    Categories
    194
    grocery → airlines
    Regions
    24
    Asia, Europe, Americas
    MCP tools
    6
    for AI assistants

    Counts from GET /api/stats

    01Capabilities

    One dataset. Every way you need to query it.

    Codes, merchants, descriptors and regions, with a source on every mapping. The same data sits behind the REST API, the hosted MCP server and the website.

    The complete MCC reference

    Every four-digit merchant category code with its category, description and usage notes. Browse it free, filter it by category or keyword, or pull it into your own tables.

    GET /api/v1/mcc-codes?search=…200
    • 5411Grocery Stores, Supermarkets
    • 5814Fast Food Restaurants
    • 4511Airlines and Air Carriers
    • 7011Hotels, Motels, and Resorts

    Merchant lookup that reads statements

    Pass a brand name or the raw card-statement descriptor. Aliases resolve to the canonical merchant, with primary and secondary MCCs.

    GET /api/v1/lookup · statement descriptor in, merchant out

    ?merchant=AMZN MKTP
    AmazonMCC 5999
    matched_alias: "AMZN MKTP"
    AMZN MKTPAMAZON.COM

    Regional coverage, Asia first

    The same brand can code differently from one country to the next. Merchants carry the regions they operate in, from Singapore and Kuala Lumpur to London and New York.

    • 🇸🇬Singapore
    • 🇲🇾Malaysia
    • 🇮🇩Indonesia
    • 🇹🇭Thailand
    • 🇵🇭Philippines
    • 🇻🇳Vietnam
    • 🇭🇰Hong Kong
    • 🇯🇵Japan
    • 🇰🇷South Korea
    • 🇮🇳India
    • 🇦🇺Australia
    • 🇬🇧United Kingdom
    • 🇪🇺Europe
    • 🇫🇷France
    • 🇩🇪Germany
    • 🇪🇸Spain
    • 🇺🇸United States
    • 🇨🇦Canada
    • +14 more

    ?region=sg · filter merchants per market (Starter+)

    MCP server for AI agents

    Point Claude, Cursor or any MCP client at the hosted server and ask in plain language. No SDK and no glue code: your API key is the only setup.

    youWhich card should I use at Starbucks in Singapore?

    ↳ find_merchant_mcc → 5814 Fast Food Restaurants

    aiStarbucks codes as MCC 5814, so use a card that rewards dining or fast food.

    POST /api/v1/mcp · streamable HTTP

    • find_merchant_mccmerchant or descriptor → MCC
    • lookup_mcc_codecode → details + merchants
    • search_mcc_codeskeyword · category · region
    • list_mcc_categoriescategories + counts
    • list_regionscoverage by region
    • get_account_usageplan and quota

    Bulk lookup and full export

    Categorize a whole statement in one call, or license the full merchant-to-MCC dataset for your own warehouse.

    POST /lookup/bulk100 / call · Pro+
    GET /export?format=csvJSON · CSV · Business

    Sourced, reviewed, correctable

    Every mapping says where it came from, with a confidence score to match. Anyone can report the MCC they saw; moderators review each report.

    • verifiedseen on real transactions
    • communityreported, reviewed by a moderator
    • curatedresearched by our team
    • inferredestimated from business type

    02Quickstart

    From API key to first category in one request.

    Plain REST over HTTPS with a single header. JSON in, JSON out: no SDK to install and nothing to keep in sync.

    • GET/api/v1/mcc-codeslist, search, filter
    • GET/api/v1/mcc-codes/:codeone code + merchants
    • GET/api/v1/lookupmerchant → MCC
    • POST/api/v1/lookup/bulk100 merchants / call
    • GET/api/v1/exportfull dataset, JSON or CSV
    • MCP/api/v1/mcphosted MCP server
    API referenceMCP setup guide
    lookup.sh9 lines
    # Which MCC does a card-statement descriptor code as?
    curl "https://www.mccexplorer.com/api/v1/lookup?merchant=AMZN%20MKTP" \
      -H "x-api-key: $MCC_API_KEY"
    
    # Categorize a batch (Pro+, up to 100 merchants per call)
    curl -X POST "https://www.mccexplorer.com/api/v1/lookup/bulk" \
      -H "x-api-key: $MCC_API_KEY" \
      -H "content-type: application/json" \
      -d '{ "merchants": ["STARBUCKS 1234", "GRAB* RIDE", "NETFLIX.COM"] }'

    03Built for

    Teams that need to know what a transaction really is.

    Expense & accounting apps

    Map card spend to ledger accounts and policy rules by MCC instead of brittle merchant-name regexes.

    5812→Meals & entertainment
    Categorization API

    Card-rewards optimizers

    Know the MCC before the tap, then recommend the card that earns the most on it across Southeast Asia.

    5411→grocery bonus card
    Best card by MCC

    Fraud & risk

    Enrich authorizations with category context and flag high-risk codes such as gambling or quasi-cash.

    7995→route to review
    Browse risk codes

    AI agents & assistants

    Give your agent ground truth on merchants and codes through MCP instead of letting it guess.

    mcp→find_merchant_mcc
    Connect over MCP

    04Pricing

    Start free. Scale by the request.

    One quota covers the REST API and the MCP server. Upgrade, downgrade or cancel from your dashboard.

    Compare all plans

    Free

    Try the API and MCP server

    $0forever

    No card required

    Requests
    100/mo
    Rate
    10/min
    • 100 requests/month (API + MCP)
    • All 1,000+ MCC codes
    • Basic merchant lookup (primary MCC)
    • Hosted MCP server
    Get a free API key

    Starter

    Recommended

    Full merchant data for individuals

    $4.99/ month

    or $49/year, save $11

    Requests
    5,000/mo
    Rate
    30/min
    • 5,000 requests/month
    • Full merchant lookup with aliases
    • Merchants per MCC + region filters
    • Full MCP toolset
    Choose Starter

    Pro

    For apps categorizing transactions

    $29/ month

    or $290/year, save $58

    Requests
    100,000/mo
    Rate
    120/min
    • 100,000 requests/month
    • Bulk lookup (100 merchants/call)
    • Confidence scores & vote data
    • Everything in Starter
    Choose Pro

    Business

    High volume and redistribution

    $149/ month

    or $1,490/year, save $298

    Requests
    1,000,000/mo
    Rate
    600/min
    • 1,000,000 requests/month
    • Full dataset export (JSON/CSV) + license
    • Priority support
    • Everything in Pro
    Choose Business

    Pay as you go, from $5

    One-time credit packs, 1 credit = 1 request. No subscription and credits never expire.

    • 2,000 credits · $5
    • 10,000 credits · $19
    • 50,000 credits · $79

    05FAQ

    Questions, answered.

    Something missing? The docs cover every endpoint, error and limit.

    What is an MCC code?

    A Merchant Category Code (MCC) is a four-digit number used by credit card companies to classify businesses by the type of goods or services they provide. MCCs are used for transaction categorization, rewards programs, and expense tracking.

    How can I use the MCC Code API?

    Sign up for a free account to get your API key. Then make HTTP requests to our REST API endpoints to retrieve MCC codes, look up merchants, and categorize transactions. See our documentation for full details and code examples.

    Is the MCC Code API free?

    Yes. The free plan includes 100 requests per month (API and MCP server), all 1,000+ MCC codes with categories and descriptions, and basic merchant lookup. Paid plans start at $4.99/month for full merchant data, with Pro and Business plans for higher volume, bulk lookup and dataset export.

    What data is included in the API?

    Our API includes over 1,000 MCC codes with categories and descriptions, 12,000+ merchants with their MCCs and regional availability across Southeast Asia, Hong Kong, Japan, India, Australia, Europe, the UK and North America, merchant aliases, confidence scores, and community vote data. Paid plans (from $4.99/month) include full merchant lookup and region filtering.

    How accurate is the merchant-to-MCC mapping data?

    Every merchant mapping shows where it comes from: verified from real transactions, reported by the community and reviewed by a moderator, curated by our team, or estimated from the merchant's business type. Confidence scores reflect that source, and anyone can report the MCC they saw on their statement to correct or confirm a mapping.

    Browse all MCC codes

    $ export MCC_API_KEY=mcc_…

    Ship MCC‑aware features this afternoon.

    100 free requests every month across the API and MCP server. No card required.

    Get a free API keyRead the docs
    MCC Explorer
    Best card by MCCExploreBlogGuidesPricingAPI DocsContactPrivacyTerms

    © 2026 MCC Explorer