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.
https://papyrascoupons.com/mcpWhat its tools do
7 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (6)
Can change data (1)
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
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
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
7 advertised
best_offer_for_url — Best coupon for a shop link
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.
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "A store or product URL, or a domain."
}
},
"additionalProperties": false
}{
"title": "Best coupon for a shop link",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_store_offers — Coupons for a store
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.
{
"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
}{
"title": "Coupons for a store",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_stores — Search stores
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.
{
"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
}{
"title": "Search stores",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}top_offers_in_category — Top offers in a category
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.
{
"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
}{
"title": "Top offers in a category",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_collection — Themed offer collection
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.
{
"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
}{
"title": "Themed offer collection",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_offer — One offer
Details of one offer by its id (from an earlier result), including whether it is still live.
{
"type": "object",
"required": [
"offer_id"
],
"properties": {
"offer_id": {
"type": "string"
}
},
"additionalProperties": false
}{
"title": "One offer",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}report_code_result — Report whether a code worked
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.
{
"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
}{
"title": "Report whether a code worked",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
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.
- 2026-11-14: 1 of 1 checks answered
- 2026-11-15: 2 of 2 checks answered
- 2026-11-16: 4 of 4 checks answered
- 2026-11-17: 5 of 5 checks answered
- 2026-11-18: 5 of 5 checks answered
- 2026-11-19: 4 of 4 checks answered
- 2026-11-20: 3 of 3 checks answered
- 2026-11-21: 4 of 4 checks answered
- 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.
Claude Code
claude mcp add --transport http papyras-coupons-mcp https://papyrascoupons.com/mcpCodex
codex mcp add papyras-coupons-mcp --url https://papyrascoupons.com/mcpCursor
{
"mcpServers": {
"papyras-coupons-mcp": {
"url": "https://papyrascoupons.com/mcp"
}
}
}Cline
{
"mcpServers": {
"papyras-coupons-mcp": {
"type": "streamableHttp",
"url": "https://papyrascoupons.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"papyras-coupons-mcp": {
"type": "http",
"url": "https://papyrascoupons.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http papyras-coupons-mcp https://papyrascoupons.com/mcpClaude Desktop
https://papyrascoupons.com/mcpWindsurf
{
"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.
Other commerce servers
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.