Skip to main content
Glama
CouponSwift MCP Server

CouponSwift MCP Server

Official
by couponswift

CouponSwift MCP server: deals and promo codes for software, hosting, VPN, proxy and AI tools

A hosted (remote) Model Context Protocol server for CouponSwift (https://www.couponswift.com), a site that lists deals and promo codes for software, hosting, VPN, proxy and AI tools. It has one read-only tool that finds a store by name, slug or domain and returns a link to its CouponSwift page together with a short summary of the current offers.

This repository contains documentation only. There is nothing to install or run.

Endpoint

https://www.couponswift.com/mcp
  • Transport: Streamable HTTP (JSON-RPC over POST). GET returns 405.

  • Authentication: none.

  • Stateless: no session is required.

  • Protocol revisions accepted: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05.

Use the URL exactly as written above, with www.

Related MCP server: pinchy

Tool: find_store

Finds stores on CouponSwift by brand name, store slug or website domain (for example hostinger, bunny.net or https://www.nordvpn.com/pricing). Returns up to 5 matching stores, best match first.

For each store it returns:

Field

Type

Meaning

name

string

Store name.

category

string or null

Top-level category name.

maxDiscount

integer or null

Highest percentage discount among the active offers; null when no offer states a percentage.

activeOffers

integer

Number of active offers shown on the store page.

url

string

The store page on CouponSwift, https://www.couponswift.com/{slug}/coupons.

Annotations: readOnlyHint: true, openWorldHint: false.

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "A brand name, a store slug or a website domain or URL, 2 to 80 characters."
    }
  },
  "required": ["query"],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "stores": {
      "type": "array",
      "maxItems": 5,
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string", "description": "Store name." },
          "category": { "type": ["string", "null"], "description": "Top-level category name, or null." },
          "maxDiscount": { "type": ["integer", "null"], "description": "Highest percentage discount among the active offers, or null." },
          "activeOffers": { "type": "integer", "description": "Number of active offers shown on the store page." },
          "url": { "type": "string", "description": "The store page on CouponSwift." }
        },
        "required": ["name", "category", "maxDiscount", "activeOffers", "url"],
        "additionalProperties": false
      }
    }
  },
  "required": ["stores"],
  "additionalProperties": false
}

Example

Request:

curl -s https://www.couponswift.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_store","arguments":{"query":"hostinger"}}}'

Example response (the numbers change as offers change):

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": false,
    "content": [
      {
        "type": "text",
        "text": "Hostinger: up to 85% off, 29 active offers. https://www.couponswift.com/hostinger/coupons"
      }
    ],
    "structuredContent": {
      "stores": [
        {
          "name": "Hostinger",
          "category": "Web Hosting",
          "maxDiscount": 85,
          "activeOffers": 29,
          "url": "https://www.couponswift.com/hostinger/coupons"
        }
      ]
    }
  }
}

When nothing matches, stores is an empty array and the text reads No store matched "<query>".

Add it to a client

Claude Code

claude mcp add --transport http couponswift https://www.couponswift.com/mcp

Claude (web and desktop apps)

Add it as a custom connector: open Customize > Connectors, click + Add, then Add custom connector, enter a name and the URL https://www.couponswift.com/mcp. See Getting started with custom connectors using remote MCP. On Team and Enterprise plans an owner adds custom connectors.

Cursor

In ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "couponswift": {
      "url": "https://www.couponswift.com/mcp"
    }
  }
}

VS Code (GitHub Copilot)

In ~/.copilot/mcp-config.json (all workspaces) or .mcp.json at the workspace root:

{
  "mcpServers": {
    "couponswift": {
      "type": "http",
      "url": "https://www.couponswift.com/mcp"
    }
  }
}

You can also run Chat: Open Customizations, select MCP Servers, then Add Server and enter the URL.

Clients without remote server support

Use mcp-remote as a local bridge (requires Node.js):

{
  "mcpServers": {
    "couponswift": {
      "command": "npx",
      "args": ["mcp-remote", "https://www.couponswift.com/mcp"]
    }
  }
}

Limits

  • Read-only, one tool.

  • No authentication and no user data. Queries are 2 to 80 characters.

  • At most 5 stores per call.

  • Stores that are not listed on CouponSwift are not returned.

License

MIT, see LICENSE. The license covers the files in this repository. The hosted service and the data it returns are not part of this repository.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to find the best online deals by browsing and interacting with multiple shopping platforms like Amazon and eBay across various regions. It uses Playwright to automate searches and retrieve product information from compatible e-commerce and deal-tracking websites.
      13 npm
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Finds coupon codes for any online store, returning likely-to-work codes for a given store domain or URL.
      1
      53 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets AI assistants search and browse a continuously verified feed of live retail and travel deals, filtering by category, store, discount, or hot status, and fetch individual deal details with current live/expired state. Results render as interactive cards in MCP Apps clients or structured text elsewhere, always linking to the deal page where the price is re-verified.
      MIT