{
  "markdown": "# GetCurrentOffer MCP Server\n\n> Search live credit card merchant offers (cash back, points, statement credits)\n> across Amex, Chase, Citi, PayPal, Rakuten, and Capital One — from any AI agent\n> that speaks the [Model Context Protocol](https://modelcontextprotocol.io).\n\nGetCurrentOffer is a **remote MCP server**. There is nothing to install. Point\nyour client at the endpoint, authenticate, and four tools are immediately\navailable.\n\n| | |\n|---|---|\n| **Endpoint** | `https://getcurrentoffer.com/api/mcp` |\n| **Transport** | Streamable HTTP (JSON-RPC 2.0) |\n| **Protocol version** | `2024-11-05` |\n| **Auth** | OAuth 2.1 + Dynamic Client Registration, **or** API key |\n| **Health** | https://getcurrentoffer.com/api/mcp/health |\n| **Manifest** | https://getcurrentoffer.com/.well-known/mcp.json |\n| **Docs** | https://getcurrentoffer.com/docs/mcp |\n| **API key signup** | https://getcurrentoffer.com/api-keys |\n| **Homepage** | https://getcurrentoffer.com |\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `search_offers` | Fuzzy search across all offers by merchant, description, or keyword. Optional issuer filter. |\n| `get_offer_details` | Look up the full record for one offer by ID. |\n| `list_merchants` | Browse every merchant with active offers, optionally filtered by issuer. |\n| `compare_offers` | Compare offers for one merchant across all six issuers and find the best deal. |\n\nFull input schemas live in [`mcp.json`](./mcp.json).\n\n## Quickstart\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)\nor `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"getcurrentoffer\": {\n      \"url\": \"https://getcurrentoffer.com/api/mcp\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The first call triggers an OAuth consent flow in your\nbrowser via Dynamic Client Registration — no API key needed.\n\n### Cursor / Windsurf / VS Code (Copilot Chat, Cline, Roo Code)\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"getcurrentoffer\": {\n        \"url\": \"https://getcurrentoffer.com/api/mcp\",\n        \"headers\": { \"X-API-Key\": \"gco_your_api_key_here\" }\n      }\n    }\n  }\n}\n```\n\nGet a free API key at https://getcurrentoffer.com/api-keys.\n\n### Continue.dev\n\n```json\n{\n  \"experimental\": {\n    \"modelContextProtocolServers\": [\n      {\n        \"transport\": {\n          \"type\": \"http\",\n          \"url\": \"https://getcurrentoffer.com/api/mcp\",\n          \"headers\": { \"X-API-Key\": \"gco_your_api_key_here\" }\n        }\n      }\n    ]\n  }\n}\n```\n\nMore client snippets in [`examples/`](./examples).\n\n## Try it from the command line\n\n```bash\n# Health check (no auth)\ncurl https://getcurrentoffer.com/api/mcp/health\n\n# List tools (with API key)\ncurl -X POST https://getcurrentoffer.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-API-Key: gco_your_api_key_here\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n\n# Search for Starbucks offers\ncurl -X POST https://getcurrentoffer.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-API-Key: gco_your_api_key_here\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 2,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"search_offers\",\n      \"arguments\": { \"query\": \"Starbucks\", \"limit\": 5 }\n    }\n  }'\n```\n\n## Authentication\n\nTwo paths, both fully supported:\n\n1. **OAuth 2.1 with Dynamic Client Registration** (RFC 7591) — recommended for\n   hosted clients like Claude Desktop, ChatGPT connectors, and Claude.ai. The\n   client discovers the auth server via the\n   [Protected Resource Metadata](./oauth-protected-resource.json) endpoint\n   advertised in `WWW-Authenticate` per RFC 9728, registers itself, then walks\n   the user through a consent screen. No manual key copying.\n\n2. **API key** — recommended for CLI tools, server-side agents, and dev/test.\n   Generate one at https://getcurrentoffer.com/api-keys and pass it via either\n   `X-API-Key: gco_…` or `Authorization: Bearer gco_…`. Free tier available.\n\nThe\n[Authorization Server Metadata](./oauth-authorization-server.json) and\n[Protected Resource Metadata](./oauth-protected-resource.json)\nin this repo are static snapshots of the live well-known endpoints — fetch the\nlive versions for the canonical source of truth.\n\n## Example prompts\n\n- \"Search for Nike credit card offers.\"\n- \"Compare offers for Starbucks across all my issuers.\"\n- \"List every merchant with an active Amex offer.\"\n- \"What dining offers are active on Chase right now?\"\n\n## Categories & tags\n\n**Categories:** finance · shopping · productivity · consumer\n\n**Tags:** credit-cards · cashback · offers · deals · rewards · amex · chase ·\nciti · paypal · rakuten · capital-one\n\n## Status\n\nProduction. Health endpoint, manifest, and OAuth metadata are all live and\nreturn `200`. The server runs on Vercel's edge with a 5-minute in-process offer\ncache backed by Postgres.\n\n## Issues / contact\n\nOpen an issue in this repo or reach out via\nhttps://getcurrentoffer.com/contact.\n\n## Trademarks & disclaimers\n\nGetCurrentOffer is an **independent** service. We are **not affiliated with,\nendorsed by, sponsored by, or approved by** American Express, JPMorgan Chase,\nCitigroup, PayPal, Rakuten, Capital One, or any other card issuer, bank,\nmerchant, or payment network mentioned in this repository or in offer data\nreturned by the API.\n\nAll product names, logos, and brands are property of their respective owners.\nAll company, product, and service names used in this repository — including\nbut not limited to \"American Express\", \"Amex\", \"Chase\", \"Citi\", \"PayPal\",\n\"Rakuten\", \"Capital One\", and any merchant names that appear in example\nprompts or returned offer data — are used for **identification purposes\nonly**. Use of these names, logos, and brands does not imply endorsement.\nThis is nominative fair use to describe the nature of the offers indexed by\nthe service.\n\nThird-party MCP client names referenced in this README (\"Claude Desktop\",\n\"Claude Code\", \"Cursor\", \"Windsurf\", \"Continue.dev\", \"VS Code\", \"Cline\",\n\"Roo Code\") are trademarks of their respective owners and are mentioned only\nto indicate compatibility.\n\n**Not financial advice.** Offer data returned by this service is provided for\n**informational purposes only** and does not constitute financial, investment,\ntax, or legal advice. Offer terms, eligibility, expiration dates, and\navailability change frequently and may differ from what is shown. Always\nverify any offer directly with the issuing bank or merchant before relying on\nit. The operators of GetCurrentOffer make no warranties, express or implied,\nabout the accuracy, completeness, currency, or fitness for any particular\npurpose of the data, and disclaim all liability for any decisions made in\nreliance on it. Use of the service is subject to the Terms of Service at\nhttps://getcurrentoffer.com.\n",
  "bytes": 6775,
  "sha": "c1650e706fbdabdda2a848227698c8063605e6e4cda64f762054683517941446",
  "repo_slug": "stanley17112000/getcurrentoffer-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_getcurrentoffer_mcp_c70264d8/readme"
}