# CashbackPro MCP Server

**Search AliExpress with real prices, live promo codes and the true post-cashback cost.** Product search with quality filters, authoritative product details, currently active promo codes, and what a purchase actually costs after cashback. Links are affiliate links, disclosed in every response; connecting a free CashbackPro account returns part of that commission to the user.

This is a **remote MCP server** (Streamable HTTP). This repository hosts the docs and manifest; the server itself runs at:

```
https://cashbackpro.org/api/mcp
```

- 🌐 Landing & setup guide: [cashbackpro.org/mcp](https://cashbackpro.org/mcp)
- 📦 Official MCP Registry: [`org.cashbackpro/cashbackpro`](https://registry.modelcontextprotocol.io/v0/servers?search=cashbackpro)

## Quick start

### Claude Code

```bash
claude mcp add --transport http cashbackpro https://cashbackpro.org/api/mcp
```

### Any MCP client (JSON config)

```json
{
  "mcpServers": {
    "cashbackpro": {
      "type": "streamable-http",
      "url": "https://cashbackpro.org/api/mcp"
    }
  }
}
```

Works out of the box — no account needed (see [Anonymous mode](#anonymous-mode) below).

## Tools

| Tool | What it does |
|---|---|
| `search_products` | Search AliExpress products (quality-filtered results) |
| `get_product_details` | Product details + estimated cashback |
| `calculate_cashback` | Estimate cashback for an amount by user level (Bronze 30% → Silver 45% → Gold 60% → Platinum 80% of the affiliate commission) |
| `get_promo_codes` | Active AliExpress promo codes tracked by CashbackPro — platform-wide and product-specific, with minimum spend and expiry. They stack with cashback |
| `get_cashback_link` | Generate an affiliate link. With a connected account the purchase is attributed to the user and earns them cashback |

## Connecting your CashbackPro account

To earn cashback, pass your personal token as a Bearer header. Get it at [cashbackpro.org/connect-extension](https://cashbackpro.org/connect-extension?utm_source=mcp-repo) (free account, sign-in with Google), then:

```json
{
  "mcpServers": {
    "cashbackpro": {
      "type": "streamable-http",
      "url": "https://cashbackpro.org/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}
```

Full walkthrough with screenshots: [cashbackpro.org/mcp](https://cashbackpro.org/mcp).

## Anonymous mode

Without a token, all tools still work. `get_cashback_link` returns a generic affiliate link — **no cashback is earned** (the commission supports the service). Anonymous responses carry both the disclosure text and a `connect_account_url` field, so an assistant can show the user how to start earning.

## Notes

- Cashback is credited after AliExpress confirms the order settlement.
- Rate limit: 30 requests/min per IP.
- Source code is not published; this repo exists for documentation and marketplace listings. Issues and questions are welcome in the [issue tracker](../../issues).

---

© [CashbackPro](https://cashbackpro.org) — AliExpress cashback platform.