Skip to main content
Glama
trypinchy

pinchy

Official
by trypinchy

pinchy-mcp

npm · MCP Registry: com.trypinchy/pinchy · trypinchy.com

MCP server that finds coupon codes for any online store. Remote endpoint: https://mcp.trypinchy.com/mcp (Streamable HTTP, no auth).

Shopping in a browser yourself? The same codes, tried for you at checkout: Pinchy – Coupon Finder & Auto Apply for Chrome.

Connect

{ "mcpServers": { "pinchy": { "type": "http", "url": "https://mcp.trypinchy.com/mcp" } } }

Claude Code: claude mcp add --transport http pinchy https://mcp.trypinchy.com/mcp

Clients that only speak stdio can run the npm package instead:

{ "mcpServers": { "pinchy": { "command": "npx", "args": ["-y", "pinchy-mcp"] } } }

Related MCP server: GoodRx MCP Server

Tool

find_coupons({ store, limit? })store is a domain or any URL on the store; limit defaults to 10 (max 50). Returns { domain, storeName?, coupons: [{ code, description?, expiresAt?, successCount?, lastWorkedAt? }] }, ordered by how likely a code is to work. An unknown store returns an empty list.

Run it yourself

pnpm install
pnpm dev          # http://127.0.0.1:4020/mcp
pnpm test

Config is read from the environment, see .env.example. The process binds to 127.0.0.1 and trusts CF-Connecting-IP for rate limiting, so expose it only through a proxy that sets that header.

Privacy Policy

The server receives a store domain and nothing else: no account, no conversation content, no identifiers. Full policy: https://trypinchy.com/privacy.html · Contact: hi@trypinchy.com

Available Tools

1 tool
find_couponsFind coupon codesA
Read-only
Inspect

Find coupon / promo / discount codes for an online store. Pass the store domain or any URL from the store (product, cart or checkout page). Returns codes ordered by how likely they are to work: try them at checkout from the top, keep the one that lowers the total the most. Codes can expire or carry store restrictions, so none is guaranteed; an empty list means none are known for that store.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of codes to return
storeYesStore domain or any URL on the store, e.g. "momcozy.com"

Output Schema

ParametersJSON Schema
NameRequiredDescription
domainYes
couponsYes
storeNameNo

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint and openWorldHint, and the description aligns with these while adding meaningful behavioral context: result ordering is by likelihood of working, results are not guaranteed, and empty lists have a defined meaning. This goes beyond the structured annotations and helps the agent set user expectations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and front-loaded: it states the purpose and input format first, then explains result ordering and caveats. Every sentence contributes useful information, with no filler or redundant phrasing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a low-complexity read-only tool with a high-coverage schema and an output schema, the description covers all essential context: what to pass, what the tool returns, how to use the results, and important limitations. Nothing critical is missing for an agent to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the input schema already documents both parameters. The description repeats the store parameter semantics but does not add new parameter-level detail beyond the schema. The baseline of 3 is appropriate because the schema carries the parameter documentation burden.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function with a specific verb and resource: find coupon/promo/discount codes for an online store. It also specifies the accepted input format (store domain or any store URL), making it unambiguous. No sibling tools exist, so differentiation is not required.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives explicit usage guidance: pass a store domain or any store URL, and explains how to interpret and act on results (try codes from the top, keep the one that lowers total the most). It also manages expectations by noting codes may expire or carry restrictions, and that an empty list means no known codes.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 1 tool updatev0.1.1
    • First observedfind_coupons

TDQS

A4.6/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap. The tool has a single, well-defined purpose.

Naming Consistency5/5

The sole tool name 'find_coupons' follows a clear verb_noun pattern, which is consistent with good naming conventions even though there is only one tool.

Tool Count3/5

The server has a single tool, which feels thin compared to typical multi-tool servers. However, the narrow purpose of finding coupons justifies a minimal surface, so it is borderline but acceptable.

Completeness5/5

The tool fully covers the stated domain of finding coupon codes for online stores. It accepts a store URL and returns actionable results, leaving no obvious gaps for its intended use.

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.
    7 npm
    3
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to search for real-time prescription drug prices, find local pharmacies, and retrieve discount coupons through the GoodRx service. It uses Playwright browser automation to provide drug comparisons and checkout details like BIN and PCN codes.
    5
    9 npm
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables users to search for hidden coupons, generate commission short links, find combined savings deals, set price drop alerts, and track historical prices for JD.com products.
    1
    -