# Feedico AI Coupon Agent

> **Ask Cursor or Claude for live affiliate coupons and merchants** — natural language in English or your local language, powered by [Feedico](https://feedico.io) and the Model Context Protocol (MCP).

**Website:** [feedico.io](https://feedico.io) · **Documentation:** [feedico.io/docs](https://feedico.io/docs) · **API:** [api.feedico.io](https://api.feedico.io)

`feedico` · `ai-agent` · `coupon-agent` · `mcp` · `cursor` · `claude` · `coupon-api` · `affiliate-api` · `merchants` · `coupons`

---

## What is this?

An **MCP server** that turns your AI IDE into a **Feedico coupon agent**:

- *“How many merchants and coupons do I have?”*
- *“List AliExpress promocodes.”*
- *“Show admitad stores with the most coupons.”*

Works in **Cursor**, **Claude Desktop**, and any MCP-compatible client.

| | |
|---|---|
| **Default language** | English (docs & MCP prompts) |
| **Ask in any language** | Turkish, German, French, Spanish, … |
| **Answers** | In the language you used |

**100+ prompt examples:** [docs/PROMPTS.md](docs/PROMPTS.md)

---

## MCP tools

| Tool | Purpose |
|------|---------|
| `feedico_catalog_summary` | Totals + connected affiliate networks |
| `feedico_list_merchants` | Stores / merchants |
| `feedico_list_coupons` | Coupon codes & deals |

## MCP prompts (built-in)

Cursor → **MCP → Prompts**:

- `feedico_catalog_summary`
- `feedico_list_merchants` / `feedico_list_coupons`
- `feedico_merchants_by_network`
- `feedico_coupons_for_store`

---

## Quick start

```bash
git clone https://github.com/feedico-io/feedico-ai-coupon-agent.git
cd feedico-ai-coupon-agent
cp .env.example .env
# Add your fdco_… token from feedico.io

npm install
```

### Cursor

`~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "feedico": {
      "command": "node",
      "args": ["/absolute/path/to/feedico-ai-coupon-agent/src/index.js"],
      "cwd": "/absolute/path/to/feedico-ai-coupon-agent"
    }
  }
}
```

Put your token in **`.env` only** — never in `mcp.json`. Restart Cursor → **Settings → Tools & MCP** → `feedico` green.

### Example questions

**English**
```
How many merchants and coupons are in my Feedico account?
List 10 AliExpress coupons from Feedico.
```

**Türkçe**
```
Feedico hesabımda kaç merchant ve kupon var?
AliExpress kuponlarını listele.
```

---

## Security

- Never commit `.env` or API tokens
- Rotate at [feedico.io](https://feedico.io) if exposed
- [SECURITY.md](SECURITY.md)

---

## Related projects

| Repo | Stack |
|------|--------|
| [feedico-wp-plugin](https://github.com/feedico-io/feedico-wp-plugin) | WordPress sync |
| [feedico-api-php-example](https://github.com/feedico-io/feedico-api-php-example) | PHP API |
| [feedico-api-python-example](https://github.com/feedico-io/feedico-api-python-example) | Python API |
| [feedico-api-node-example](https://github.com/feedico-io/feedico-api-node-example) | Node.js API |
| [feedico-api-csharp-example](https://github.com/feedico-io/feedico-api-csharp-example) | C# API |
| [feedico-api-postman](https://github.com/feedico-io/feedico-api-postman) | Postman |
| [feedico-etl-starter](https://github.com/feedico-io/feedico-etl-starter) | ETL warehouse |

---

## License

MIT