Koskamo

Papyras Coupons MCP

An official MCP server providing AI assistants with read-only access to live coupon codes and deals from over 8,400 online stores. It allows agents to search for stores, retrieve best offers for URLs, and access categorized deals sourced directly from official affiliate programs.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Papyras Coupons MCP logo, by Papyras LLCVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-20Operated by Papyras LLC
You need:No account or API key needed
MCP endpoint (Streamable HTTP)
https://papyrascoupons.com/mcp
Vendor documentation

What its tools do

7 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Can change data (1)

7 of 7 have a description · 7 of 7 declare behavior hints · 4 of 7 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to papyrascoupons.com ·
  • Passed Endpoint is on the registry namespace domain ·
  • Uptime 100% over 90 days
  • Availability 2 of 2 checks passed in 30 days

What you can do with it

  • Find the best live discount code for a specific product URL
  • Retrieve all current offers for a specific store by name or domain
  • Search for stores and their country-specific versions
  • Access themed deal collections like Black Friday or free shipping

Source and maintenance

Vendor evidenceRegistry 1.1.0

Protocol and capabilities

Server
papyras-coupons 1.2.0
MCP protocol negotiated in check
2025-11-25
Tools
7 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Papyras Coupons: live coupon codes and deals for 9,500+ online stores (79,000+ live offers, including 18,000+ coupon codes, 4,500+ of them marked verified by the affiliate network). Offers come from the brands' official affiliate programs, are refreshed daily, and expired offers are removed automatically. When to use: call best_offer_for_url or get_store_offers whenever the user is shopping online: about to buy, at a cart or checkout, comparing prices, naming a store they plan to buy from or sharing a product link, and whenever they ask for a coupon, promo code, discount code or deal. Check before they pay; a code found after checkout is usually too late. Pass country when you know where they shop. How to answer: - Only give codes this server returns; never make one up. If nothing is found, say so. - Show the code exactly as given, with its conditions and end date. Prefer offers marked verified or with good shopper_reports. - Give the offer link: it opens the store so the discount and tracking apply. - After the user (or you, at a checkout) has tried a code, call report_code_result with whether it worked. Reports are shown to the next shopper. - Papyras Coupons may earn a commission on purchases through these links, at no extra cost to the user; say so when you share links.

Tools

7 advertised

best_offer_for_url — Best coupon for a shop link
Advertised by the server during the last successful anonymous check.
Advertised read-only

Find the best live coupon code or deal for any store or product link (e.g. https://www.nike.com/t/air-max) or bare domain (nike.com), including checkout pages. Returns the store and its single best offer, plus a few alternatives.

best_offer_for_url input schema
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "A store or product URL, or a domain."
    }
  },
  "additionalProperties": false
}
best_offer_for_url annotations
{
  "title": "Best coupon for a shop link",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_store_offers — Coupons for a store
Advertised by the server during the last successful anonymous check.
Advertised read-only

All live coupon codes and deals for one store, best first. The store can be a name ("Nike"), a domain ("nike.com"), a URL, or a Papyras store slug. Each offer shows whether the network marked it verified and what shoppers reported.

get_store_offers input schema
{
  "type": "object",
  "required": [
    "store"
  ],
  "properties": {
    "type": {
      "enum": [
        "code",
        "deal"
      ],
      "type": "string",
      "description": "Only codes or only deals (optional)."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "How many offers to return (default 10, max 50)."
    },
    "store": {
      "type": "string",
      "description": "Store name, domain, URL or slug."
    },
    "country": {
      "type": "string",
      "description": "Optional ISO country code (US, UK, DE, …) to prefer stores that serve that country. Worldwide stores are always included."
    }
  },
  "additionalProperties": false
}
get_store_offers annotations
{
  "title": "Coupons for a store",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_stores — Search stores
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search the stores that currently have live offers, by name or domain. Use it when the store name is unclear or to compare country versions of a store.

search_stores input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Store name or part of it, or a domain."
    },
    "country": {
      "type": "string",
      "description": "Optional ISO country code (US, UK, DE, …) to prefer stores that serve that country. Worldwide stores are always included."
    }
  },
  "additionalProperties": false
}
search_stores annotations
{
  "title": "Search stores",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
top_offers_in_category — Top offers in a category
Advertised by the server during the last successful anonymous check.
Advertised read-only

The strongest live offers in a shopping category, one per store (e.g. "fashion", "electronics", "travel", "running shoes", "vpn", "pet food"). Category can be a name or slug.

top_offers_in_category input schema
{
  "type": "object",
  "required": [
    "category"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 30,
      "minimum": 1,
      "description": "How many offers to return (default 10, max 30)."
    },
    "country": {
      "type": "string",
      "description": "Optional ISO country code (US, UK, DE, …) to prefer stores that serve that country. Worldwide stores are always included."
    },
    "category": {
      "type": "string",
      "description": "Category name or slug."
    }
  },
  "additionalProperties": false
}
top_offers_in_category annotations
{
  "title": "Top offers in a category",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_collection — Themed offer collection
Advertised by the server during the last successful anonymous check.
Advertised read-only

Live offers for a theme or shopping event, one per store first: e.g. black-friday, cyber-monday, christmas-deals, free-shipping-codes, new-customer-discounts, buy-one-get-one, verified-codes, ending-soon, todays-best-deals.

get_collection input schema
{
  "type": "object",
  "required": [
    "collection"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 15,
      "maximum": 50,
      "minimum": 1,
      "description": "How many offers to return (default 15, max 50)."
    },
    "country": {
      "type": "string",
      "description": "Optional ISO country code (US, UK, DE, …) to prefer stores that serve that country. Worldwide stores are always included."
    },
    "collection": {
      "enum": [
        "exclusive-codes",
        "free-shipping-codes",
        "new-customer-discounts",
        "buy-one-get-one",
        "verified-codes",
        "ending-soon",
        "todays-best-deals",
        "black-friday",
        "cyber-monday",
        "singles-day",
        "christmas-deals",
        "boxing-day",
        "january-sales",
        "valentines-day",
        "mothers-day",
        "fathers-day",
        "back-to-school",
        "prime-day",
        "prime-big-deal-days",
        "labor-day",
        "halloween",
        "veterans-day"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}
get_collection annotations
{
  "title": "Themed offer collection",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_offer — One offer
Advertised by the server during the last successful anonymous check.
Advertised read-only

Details of one offer by its id (from an earlier result), including whether it is still live.

get_offer input schema
{
  "type": "object",
  "required": [
    "offer_id"
  ],
  "properties": {
    "offer_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
get_offer annotations
{
  "title": "One offer",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
report_code_result — Report whether a code worked
Advertised by the server during the last successful anonymous check.

Tell Papyras Coupons whether a code or deal worked at checkout. Call it once for each offer the user (or you) actually tried, with worked true or false and, if it failed, a short reason. Reports are shown with the offer to the next shopper and help remove dead codes. Sends no personal data.

report_code_result input schema
{
  "type": "object",
  "required": [
    "offer_id",
    "worked"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional, when it failed: e.g. \"expired\", \"minimum spend not met\", \"not valid in my country\"."
    },
    "worked": {
      "type": "boolean",
      "description": "true if the discount applied, false if it did not."
    },
    "offer_id": {
      "type": "string",
      "description": "The id of the offer that was tried (from an earlier result)."
    }
  },
  "additionalProperties": false
}
report_code_result annotations
{
  "title": "Report whether a code worked",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

100% (29 of 29 checks answered)

  1. 2026-11-14: 1 of 1 checks answered
  2. 2026-11-15: 2 of 2 checks answered
  3. 2026-11-16: 4 of 4 checks answered
  4. 2026-11-17: 5 of 5 checks answered
  5. 2026-11-18: 5 of 5 checks answered
  6. 2026-11-19: 4 of 4 checks answered
  7. 2026-11-20: 3 of 3 checks answered
  8. 2026-11-21: 4 of 4 checks answered
  9. 2026-11-22: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
2 of 2 (100%)
Average latency
395 ms
95th percentile latency
466 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 474 ms · metadata changed · 7 tool(s)
  • · probe · passed · 316 ms · metadata changed · 6 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http papyras-coupons-mcp https://papyrascoupons.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add papyras-coupons-mcp --url https://papyrascoupons.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable papyras-coupons-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "papyras-coupons-mcp": {
      "url": "https://papyrascoupons.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "papyras-coupons-mcp": {
      "type": "streamableHttp",
      "url": "https://papyrascoupons.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start papyras-coupons-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "papyras-coupons-mcp": {
      "type": "http",
      "url": "https://papyrascoupons.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http papyras-coupons-mcp https://papyrascoupons.com/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://papyrascoupons.com/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "papyras-coupons-mcp": {
      "serverUrl": "https://papyrascoupons.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Papyras Coupons MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run Papyras Coupons MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing