{
  "markdown": "# CardDeals MCP Server [![MCP](https://img.shields.io/badge/MCP-Streamable%20HTTP-blue?style=for-the-badge)](https://carddeals.co/mcp) [![Website](https://img.shields.io/badge/Website-carddeals.co-00D084?style=for-the-badge)](https://carddeals.co/mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](LICENSE)\n\nOfficial Model Context Protocol (MCP) server for **[CardDeals](https://carddeals.co)** — 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).\n\n* 🌐 **Landing Page & Documentation:** [https://carddeals.co/mcp](https://carddeals.co/mcp)\n* ⚡ **Remote MCP Endpoint:** `https://catalog.carddeals.co/mcp`\n* 📑 **OpenAPI REST Specification:** [https://catalog.carddeals.co/openapi.json](https://catalog.carddeals.co/openapi.json)\n* 📋 **Registry Metadata:** [https://catalog.carddeals.co/mcp/server.json](https://catalog.carddeals.co/mcp/server.json)\n\n---\n\n## 🚀 Key Features\n\n* **Anonymous & Free:** No authentication, account creation, or API keys required during public beta.\n* **Safe & Read-Only:** Exposes discovery and price comparison tools with zero mutation or direct checkout permissions.\n* **Streamable HTTP:** Modern remote MCP transport compatible with Claude Desktop, Cursor, and standard MCP clients.\n* **Real-Time Data:** Live discount rates, seller observation timestamps, and condition disclosures across secondary marketplaces.\n\n---\n\n## 🛠️ Available MCP Tools\n\n| Tool | Description | Example Query |\n|---|---|---|\n| `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\"* |\n| `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\"* |\n| `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\"* |\n\n---\n\n## ⚙️ Client Quickstart\n\n### 1. Claude Desktop\n\nAdd the following to your `claude_desktop_config.json`:\n\n* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n* **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"carddeals\": {\n      \"type\": \"http\",\n      \"url\": \"https://catalog.carddeals.co/mcp\"\n    }\n  }\n}\n```\n\n### 2. Cursor IDE\n\nAdd to your project's `.cursor/mcp.json` or global MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"carddeals\": {\n      \"type\": \"http\",\n      \"url\": \"https://catalog.carddeals.co/mcp\"\n    }\n  }\n}\n```\n\n### 3. REST / OpenAPI Alternative\n\nIf your agent framework prefers OpenAPI or REST tool calling:\n\n```bash\n# Search deals by brand\ncurl \"https://catalog.carddeals.co/v1/deals/search?q=starbucks&limit=5\"\n\n# Get brand details\ncurl \"https://catalog.carddeals.co/v1/deals/brands/starbucks\"\n\n# Batch lookup\ncurl \"https://catalog.carddeals.co/v1/deals/lookup?ids=starbucks,target,airbnb\"\n```\n\n---\n\n## 🔒 Safety & Freshness Rules\n\n* **Freshness:** Deals, discounts, and inventory fluctuate constantly. Tools return observation timestamps (`fetched_at`) and assembly timestamps (`as_of`).\n* **Validation:** Recheck the destination seller before completing a purchase.\n* **Disclosures:** Third-party affiliate links and CardDeals-owned inventory are clearly labeled in response metadata.\n\n---\n\n## 📄 License\n\nMIT License. See [LICENSE](LICENSE) for details.\n",
  "bytes": 3607,
  "sha": "6ce2058586f308ccbd365791f7195e6c3d966a4db12d836fa1e140f68e096760",
  "repo_slug": "cello305/carddeals-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cello305_carddeals_mcp_068afdac/readme"
}