CardDeals Live Gift Card Deals

io.github.cello305Published by GitHub account cello305v1.0.1Updated Nov 2, 2026

Search current U.S. gift-card discounts from validated providers. Anonymous and read-only.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Read-only remote MCP server that lets an assistant search and compare current U.S. discounted gift-card offers across brands and categories.

What you can do
  • Search gift-card deals by brand text or category, returning up to 10 products with provider offers and links
  • Get complete current provider details, sellers and conditions for one exact brand slug, product ID or brand name
  • Batch-resolve up to 10 exact product IDs or brand slugs in a single call, with unknown IDs reported as not found
  • Return observation and assembly timestamps alongside offers so freshness can be judged
When to use it
Useful when a user wants to discover, compare or check current discounted gift-card offers for U.S. brands, or asks for deals in a category such as dining, retail, travel or tech.
Requirements
A remote streamable HTTP endpoint; no authentication, account, API key or local runtime is required during the public beta. Network access to the provider's endpoint is needed.
Before you install
Offers are read-only and no purchase action is exposed, but discounts and inventory change constantly, so the destination seller should be rechecked before buying. Responses may include third-party affiliate links and CardDeals-owned inventory, labeled in metadata.

Installation

In SourceWeft

  1. Open CardDeals Live Gift Card Deals in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.cello305%2Fcarddeals-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "carddeals-live-gift-card-deals": {
      "type": "http",
      "url": "https://catalog.carddeals.co/mcp"
    }
  }
}

README

CardDeals MCP Server [MCP] [Website] [License: MIT]

Official Model Context Protocol (MCP) server for CardDeals — query and compare real-time discounted digital gift cards across 700+ top retail, dining, travel, and entertainment brands directly inside AI assistants (Claude, Cursor, ChatGPT, and autonomous purchasing agents).


🚀 Key Features

  • Anonymous & Free: No authentication, account creation, or API keys required during public beta.
  • Safe & Read-Only: Exposes discovery and price comparison tools with zero mutation or direct checkout permissions.
  • Streamable HTTP: Modern remote MCP transport compatible with Claude Desktop, Cursor, and standard MCP clients.
  • Real-Time Data: Live discount rates, seller observation timestamps, and condition disclosures across secondary marketplaces.

🛠️ Available MCP Tools

ToolDescriptionExample Query
search_gift_card_dealsSearch current discounts by brand text or category (Food, Retail, Travel, Tech, Fashion). Returns up to 10 products."Find dining deals for date night"
get_gift_card_dealsRetrieve all current validated offers, sellers, and conditions for a specific brand slug or product ID."Get current Starbucks gift card deals"
lookup_gift_card_dealsBatch resolve up to 10 brand slugs or product IDs in a single call."Check discounts for Apple, Target, and Airbnb"

⚙️ Client Quickstart

1. Claude Desktop

Add the following to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "carddeals": {      "type": "http",      "url": "https://catalog.carddeals.co/mcp"    }  }}

2. Cursor IDE

Add to your project's .cursor/mcp.json or global MCP settings:

json
{  "mcpServers": {    "carddeals": {      "type": "http",      "url": "https://catalog.carddeals.co/mcp"    }  }}

3. REST / OpenAPI Alternative

If your agent framework prefers OpenAPI or REST tool calling:

bash
# Search deals by brandcurl "https://catalog.carddeals.co/v1/deals/search?q=starbucks&limit=5"
# Get brand detailscurl "https://catalog.carddeals.co/v1/deals/brands/starbucks"
# Batch lookupcurl "https://catalog.carddeals.co/v1/deals/lookup?ids=starbucks,target,airbnb"

🔒 Safety & Freshness Rules

  • Freshness: Deals, discounts, and inventory fluctuate constantly. Tools return observation timestamps (fetched_at) and assembly timestamps (as_of).
  • Validation: Recheck the destination seller before completing a purchase.
  • Disclosures: Third-party affiliate links and CardDeals-owned inventory are clearly labeled in response metadata.

📄 License

MIT License. See LICENSE for details.

Source: README.md at commit 69f7441

Tools

3

search_gift_card_deals

Search live gift-card deals

Use this when the user wants to discover or compare current U.S. gift-card discounts across brands or within a category. Returns structured provider offers and current destination links. Do not use it for an exact single brand when get_gift_card_deals can return the complete provider set.

Parameterssortlimitquerycategorymin_discount_percent

lookup_gift_card_deals

Look up multiple gift-card brands

Use this when the user supplies up to 10 exact CardDeals product IDs or brand slugs to compare in one call. Product IDs use the form brand:starbucks. Do not use it for fuzzy discovery; use search_gift_card_deals instead. Unknown IDs are returned in not_found instead of being guessed.

Parametersidsrequired

get_gift_card_deals

Get live deals for one gift-card brand

Use this when the user asks for complete current provider details for one exact gift-card brand. Accepts a brand slug, product ID such as brand:starbucks, or exact brand name. Do not use it for broad category discovery. Returns no purchase action—only current provider or CardDeals checkout links.

Parametersbrandrequired

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts