
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).GETreturns405. - 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:
| 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.
Links
- Website: https://www.couponswift.com
- Contact: https://www.couponswift.com/contact
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.