GetCurrentOffer MCP server

GetCurrentOffer MCP Server

Search live credit card merchant offers (cash back, points, statement credits)

across Amex, Chase, Citi, PayPal, Rakuten, and Capital One — from any AI agent

that speaks the Model Context Protocol.

GetCurrentOffer is a remote MCP server. There is nothing to install. Point your client at the endpoint, authenticate, and four tools are immediately available.

Tools

Full input schemas live in mcp.json.

Quickstart

Claude Desktop

Add to ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):

{
  "mcpServers": {
    "getcurrentoffer": {
      "url": "https://getcurrentoffer.com/api/mcp"
    }
  }
}

Restart Claude Desktop. The first call triggers an OAuth consent flow in your browser via Dynamic Client Registration — no API key needed.

Cursor / Windsurf / VS Code (Copilot Chat, Cline, Roo Code)

{
  "mcp": {
    "servers": {
      "getcurrentoffer": {
        "url": "https://getcurrentoffer.com/api/mcp",
        "headers": { "X-API-Key": "gco_your_api_key_here" }
      }
    }
  }
}

Get a free API key at https://getcurrentoffer.com/api-keys.

Continue.dev

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "http",
          "url": "https://getcurrentoffer.com/api/mcp",
          "headers": { "X-API-Key": "gco_your_api_key_here" }
        }
      }
    ]
  }
}

More client snippets in examples/.

Try it from the command line

# Health check (no auth)
curl https://getcurrentoffer.com/api/mcp/health

# List tools (with API key)
curl -X POST https://getcurrentoffer.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gco_your_api_key_here" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Search for Starbucks offers
curl -X POST https://getcurrentoffer.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gco_your_api_key_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_offers",
      "arguments": { "query": "Starbucks", "limit": 5 }
    }
  }'

Authentication

Two paths, both fully supported:

hosted clients like Claude Desktop, ChatGPT connectors, and Claude.ai. The client discovers the auth server via the Protected Resource Metadata endpoint advertised in WWW-Authenticate per RFC 9728, registers itself, then walks the user through a consent screen. No manual key copying.

1. OAuth 2.1 with Dynamic Client Registration (RFC 7591) — recommended for

Generate one at https://getcurrentoffer.com/api-keys and pass it via either X-API-Key: gco… or Authorization: Bearer gco…. Free tier available.

1. API key — recommended for CLI tools, server-side agents, and dev/test.

Shortened. The full README is on GitHub.