CardDeals MCP Server

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).

🌐 Landing Page & Documentation: https://carddeals.co/mcp
⚡ Remote MCP Endpoint: https://catalog.carddeals.co/mcp
📑 OpenAPI REST Specification: https://catalog.carddeals.co/openapi.json
📋 Registry Metadata: https://catalog.carddeals.co/mcp/server.json

🚀 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

Tool	Description	Example Query
`search_gift_card_deals`	Search 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_deals`	Retrieve all current validated offers, sellers, and conditions for a specific brand slug or product ID.	"Get current Starbucks gift card deals"
`lookup_gift_card_deals`	Batch 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

{
  "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:

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

3. REST / OpenAPI Alternative

If your agent framework prefers OpenAPI or REST tool calling:

# Search deals by brand
curl "https://catalog.carddeals.co/v1/deals/search?q=starbucks&limit=5"

# Get brand details
curl "https://catalog.carddeals.co/v1/deals/brands/starbucks"

# Batch lookup
curl "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.

CardDeals Live Gift Card Deals