Repository avatar
AI Tools
v1.0.0
active

couponswift

io.github.couponswift/couponswift

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

Documentation

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.

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:

FieldTypeMeaning
namestringStore name.
categorystring or nullTop-level category name.
maxDiscountinteger or nullHighest percentage discount among the active offers; null when no offer states a percentage.
activeOffersintegerNumber of active offers shown on the store page.
urlstringThe 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.

Links

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.

No installation packages available.

Remote