GotCashback MCP Server

Connect Claude, ChatGPT, and other MCP-compatible AI assistants directly to GotCashback's current cashback rates (online and in-store, across cashback portals), portal comparisons and payout terms, store data, and gift card deals — refreshed several times a day.

ph.GotCashback.com compares cashback rates across 98 cashback portals in 41 countries worldwide, including 2 portals and 200 stores in the Philippines. Founded in 2020; operated by MNP Enterprises, LLC.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools and pull current data during a conversation. Instead of an AI guessing at cashback rates from outdated training data, it can query GotCashback's server directly and get today's numbers.

Installation instructions

Claude (claude.ai / Claude Desktop)

1. Open Settings → Connectors (in Claude Desktop: Settings → Connectors; on claude.ai: the connectors icon in a chat).
2. Click "Add custom connector".
3. Enter the URL: https://mcp.gotcashback.com
4. Give it a name (e.g. "GotCashback") and save.
5. Enable the connector in any conversation where you want cashback lookups — Claude will call the tools automatically when relevant.

Claude Code (terminal)

Add the server with one command:

claude mcp add --transport http gotcashback https://mcp.gotcashback.com

Run /mcp inside Claude Code to check the connection, and to sign in when you want the account tools.

ChatGPT

1. Open Settings → Connectors (available on plans that support custom/developer connectors).
2. Choose to add a custom connector and enter the server URL: https://mcp.gotcashback.com
3. Follow the prompts to authorize and enable it for use in chat or in a custom GPT's configuration.

VS Code (GitHub Copilot agent mode)

Run "MCP: Add Server" from the command palette, or add this to .vscode/mcp.json:

{
  "servers": {
    "gotcashback": {
      "type": "http",
      "url": "https://mcp.gotcashback.com"
    }
  }
}

Other MCP-compatible clients (Cursor, Windsurf, etc.)

Most MCP clients accept a JSON config pointing at a remote server. A typical entry looks like:

{
  "mcpServers": {
    "gotcashback": {
      "url": "https://mcp.gotcashback.com"
    }
  }
}

Check your specific client's documentation for where this config file lives (e.g. ~/.cursor/mcp.json for Cursor) — the URL and structure above are the same across most clients since they follow the same MCP spec.

Example prompts once connected

• "What's the best cashback rate for Best Buy right now?"
• "Are there any discounted gift cards for Target?"
• "What's the best cashback rate for Walmart in Canada?"
• "Compare gift card discounts for Home Depot."
• "Which cashback portals are available in the UK?"
• "Where can I buy Adidas products with the best cashback?"
• "Where can I buy dog food with the biggest discount?"
• "Which UK cashback portals pay via PayPal, and which one has the lowest minimum payout?"
• "Does TopCashback offer a sign-up bonus, and how often does it pay out?"
• "Alert me when Nike's cashback rate reaches 10%."
• "Add Best Buy to my favorite stores."

The last two use the optional account tools and will prompt you to sign in with your GotCashback account.

Prefer chatting on Telegram instead? Try the GotCashback Telegram bot

What the GotCashback MCP server does

Once connected, an AI assistant can compare current online and in-store cashback rates across portals for a given store, find discounted gift cards, rank the stores carrying a brand or shopping category by best deal, browse stores by country, and look up each portal's payout terms (sign-up bonus, minimum payout, payment frequency, payment methods). The server tells the assistant which tool answers which kind of question, so a plain question like "best cashback for Walmart" goes straight to the right lookup. Rates are refreshed several times a day.

How an assistant picks a tool

The server tells connected assistants which tool answers which question, so you can ask naturally:

• Cashback for a named store ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") → get_cashback_rates_by_store_name
• Discounted gift cards for a named store ("best Gap gift card discount") → get_gift_cards_by_store_name
• Where to buy a brand's products with the most savings ("best cashback on Adidas products") → get_best_deals_by_brand
• Where to buy a type of product with the most savings ("cheapest dog food with cashback") → get_best_deals_by_category
• A portal's sign-up bonus, minimum payout, payment schedule or payout methods → get_portals_by_name / get_portals
• Which stores offer cashback in a country → get_stores_by_country

Mention a country when it matters ("in Canada", "UK cashback"): the assistant passes a lowercase country code such as us, ca, gb (United Kingdom) or de, and searches every supported country when you don't.

Assistants go straight to these tools — they never need to list countries, stores or portals first.

Available tools

country_code is a lowercase ISO code such as us, ca, gb (United Kingdom) or de; it is optional unless shown as required. store_id, portal_id and similar IDs come from an earlier result.

Tracked links in results

Every store, cashback rate, gift card and portal sign-up bonus in a result carries a tracked GotCashback link (url, plus gift_cards_url where relevant). Cashback is only credited, gift card discounts only apply, and sign-up bonuses are only granted when you click through those links. The server instructs AI clients to always show them — if an assistant quotes a rate without a link, ask it for the link.

Account tools (optional sign-in)

Signing in with your GotCashback account (OAuth 2.1 — your AI client will offer it automatically) unlocks additional per-user tools. All the comparison tools above keep working without signing in.

Alerts are the same ones you manage under Account → Alerts on the website: alert_type is cashback or gift_card, threshold_percent is between 1 and 100, re-saving an existing alert updates its threshold and re-arms it, and each account can have at most 10 active alerts.

How sign-in works

1. The first time you use an account tool, the server answers with an authorization challenge and your AI client opens the GotCashback sign-in page in your browser — the same social login as the website. No registration or API key is needed.
2. Approve the requested permissions (scopes) and return to your client. The tool call completes, and the connection stays signed in — clients that request offline_access receive refresh tokens, so you won't be asked again.
3. To disconnect, remove the connector from your AI client. If a tool later reports a missing scope, remove and re-add the connector so the client requests authorization afresh.

Server endpoint

https://mcp.gotcashback.com

This is a remote MCP server (Streamable HTTP transport). You don't need to install or host anything — just point a compatible AI assistant at the URL above.

For developers and AI agents

The server (version 1.1.0) exposes tools only (no resources or prompts). Every tool has a title, a description that says when to use it, read-only annotations and — for the comparison tools — a published output schema. These endpoints let an agent or integration discover and connect to it without reading this page:

Comparison tools return the raw API JSON as text plus typed structured content that matches their output schema, so integrations can read store, portal, rate, "up to" and online/in-store fields without guessing. Unknown IDs and API outages come back as tool errors rather than protocol failures.

• https://mcp.gotcashback.com — MCP endpoint — Streamable HTTP, JSON-RPC over POST, stateless (no session affinity needed)
• https://mcp.gotcashback.com/.well-known/mcp/server-card.json — MCP server card describing the server, transport and authentication (also served on this site)
• https://mcp.gotcashback.com/.well-known/oauth-protected-resource — OAuth protected resource metadata: supported scopes and the authorization server
• https://www.gotcashback.com/.well-known/oauth-authorization-server — Authorization server metadata — authorization code flow with PKCE, dynamic client registration (public and confidential clients), refresh tokens
• https://www.gotcashback.com/auth.md — Agent authentication policy
• https://www.gotcashback.com/llms.txt — Agent-readable site index
• https://api.gotcashback.com/swagger/ — The free REST API behind the tools (OpenAPI spec, no key required)
• https://mcp.gotcashback.com/health — Health check

CORS is open to any origin, so browser-based agents can connect directly; the Mcp-Session-Id and WWW-Authenticate response headers are exposed.

Questions or issues?

If a connection fails or a tool call errors out, double-check the URL is entered exactly as https://mcp.gotcashback.com with no trailing path. If an account tool keeps asking you to sign in, remove and re-add the connector. For further help, contact GotCashback support.