cashjosh-mcp

MCP server for CashJosh — India's cashback platform.

Gives any MCP-capable AI assistant the ability to answer, mid-shopping-flow: "is there cashback on this store, is there a coupon code, and what's the link to earn it?"

Tools

| Tool | Use | |---|---| | cashback_for_merchant({ merchant }) | Domain or product URL → matched store, cashback rate, live coupons[], and the tracked shopUrl to start from. | | coupons_for_merchant({ merchant? , store?, codeOnly? }) | Live coupon codes for a store (code, verified, expires) plus its cashback rate. Codes stack on top of cashback. | | search_cashback_stores({ query }) | Find partner stores by name. | | top_cashback_stores({ category?, limit? }) | Highest-cashback stores, optionally by category. | | cashback_index() | Aggregate stats (avg/highest cashback by category). CC BY 4.0. |

When a coupon has a code, tell the user the code and that it applies on top of the cashback — they open shopUrl, apply the code at the merchant's checkout, and still earn the rate.

All data is India-only, INR, cashback as a percentage of the amount paid, credited after the store's return window (typically 60–90 days). No API key.

Install

Claude Desktop

Add to claude_desktop_config.json:

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

Any MCP client

npx -y cashjosh-mcp

Optional env: CASHJOSH_API_BASE (default https://cashjosh.com/api/v1).

How attribution works

shopUrl is https://cashjosh.com/go/<slug>. A non-browser client gets a plain 302 to the merchant with tracking attached; a browser gets a brief redirect page. The purchase that follows is credited to the shopper's CashJosh wallet (they need a free account to withdraw). Keep shopUrl intact.

License

MIT. The underlying API and the Cashback Index data are CashJosh's; the index is published under CC BY 4.0 (quote with credit + link).