MCP Dealfinder

MCP DealFinder

Turn your affiliate feeds into AI shopping answers with your tracked links and a clear disclosure.

MCP server for affiliate marketers that lets AI assistants search product feeds from Awin, Amazon, Commission Junction, Impact, 2Performant, and any network — and return buy links built with your own affiliate IDs. Works with Claude, ChatGPT, Cursor, and any MCP-compatible AI.

---

⚡ Quick Install

Add to Cursor

One-click install: Click the badge above or use this deeplink:

cursor://anysphere.cursor-deeplink/mcp/install?name=dealfinder&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1kZWFsZmluZGVyIl19

Manual setup: Add to your Cursor MCP settings or .cursor/mcp.json:

{

"mcpServers": { "dealfinder": { "command": "npx", "args": ["-y", "mcp-dealfinder"], "env": { "DEALFINDER_CONFIG": "/absolute/path/to/dealfinder.config.json" } } } }

Add to Claude

Claude Code (CLI):

claude mcp add dealfinder -- npx -y mcp-dealfinder

Claude Desktop: Add to claude_desktop_config.json:

{

"mcpServers": { "dealfinder": { "command": "npx", "args": ["-y", "mcp-dealfinder"], "env": { "DEALFINDER_CONFIG": "/absolute/path/to/dealfinder.config.json" } } } }

Add to VS Code

One-click install: Install in VS Code

Manual setup: Create or edit .vscode/mcp.json in your workspace:

{

"mcpServers": { "dealfinder": { "command": "npx", "args": ["-y", "mcp-dealfinder"], "env": { "DEALFINDER_CONFIG": "/absolute/path/to/dealfinder.config.json" } } } }

Run with npx

npx -y mcp-dealfinder

Environment Variables

Set DEALFINDER_CONFIG to the absolute path of your configuration file containing affiliate network credentials and feed URLs.

Demo Mode: Run without DEALFINDER_CONFIG to test with fictional demo products.

*"Find noise-cancelling headphones under 150 EUR and compare the top two"*

⭐ Star this repository if it helps you! → Give a star

---

🎬 Demo

---

---

📋 Table of Contents

• Why MCP DealFinder?
• Features
• Use Cases & Example Prompts
• How It Compares
• Configure Your Feeds
• Supported Networks
• Compliance
• Build on It (Library API)
• Development
• FAQ
• Contributing
• License
• About the Author

---

Why MCP DealFinder?

You're an affiliate marketer. You want AI to recommend products from your feeds with *your* tracked links — not send customers to Amazon with someone else's affiliate ID, or hallucinate product details.

DealFinder solves this:

• ✅ Search your own product feeds from any affiliate network
• ✅ Every link includes your affiliate IDs (never generic or missing)
• ✅ Clear disclosure text ships with every tracked link
• ✅ Works with Awin, Amazon, CJ, Impact, 2Performant, and any deep-link network
• ✅ Ranked by relevance or price, never commission (keeps it honest)
• ✅ Local CSV/JSON feeds (no API keys, no rate limits, no external dependencies)

---

Features

Tools

All tools accept an optional `sub_id` parameter to tag links for tracking (e.g., campaign name, post ID, or page slug). This appears in your network's reports.

Core Capabilities

• Multi-network support: Awin, Amazon Associates, CJ, Impact, 2Performant, Profitshare, or any network with a deep-link template
• Feed flexibility: CSV or JSON, local files or URLs, .gz automatically decompressed
• European price parsing: Handles 1.299,99, 19,99, and € 24.50 formats
• Graceful fallback: If a tracked link can't be built (missing config), returns the plain merchant URL and marks it tracked: false
• Validation tool: npm run check loads feeds and reports product counts, coverage, price ranges, and sample links before you connect an AI

---

Use Cases & Example Prompts

1. Product Recommendations

*"Find the best ergonomic office chair under $300"*

*"Show me noise-cancelling headphones available from these merchants: TechGear, SoundPro"*

2. Price Comparisons

*"Compare the top 3 espresso machines between 200-400 EUR"*

*"Find the cheapest laptop with 16GB RAM from my Awin feed"*

3. Niche Research

*"Search for vegan protein powder from Impact merchants"*

*"What cameras under 800 EUR are in my feeds right now?"*

4. Content Creation

*"Find 5 winter jackets under $150 and write a comparison post with affiliate links"*

*"Search for budget gaming keyboards and create a buying guide"*

---

How It Compares

*As of October 2026. Corrections welcome.*

DealFinder is for you if:

• You already have affiliate feeds from Awin, Amazon, or other networks
• You want full control over your data (local CSVs, no external API dependencies)
• You need tracked links with *your* IDs, not program discovery

Consider alternatives if:

• [OpenAffiliate](https://github.com/Affitor/open-affiliate) — You're exploring new affiliate programs and need a searchable registry (not product search).
• [Affiliate.com MCP](https://guides.affiliate.com/guides/mcp) — You're already an Affiliate.com customer and want OAuth-integrated product search.

---

Configure Your Feeds

Copy examples/dealfinder.config.example.json to dealfinder.config.json (gitignored) and set the DEALFINDER_CONFIG environment variable.

Configuration Structure

{

"networks": { "awin": { "kind": "awin", "publisherId": "YOUR_PUBLISHER_ID", "apiKey": "YOUR_API_KEY" }, "amazon": { "kind": "amazon", "tag": "yourtag-20" } }, "feeds": [ { "url": "https://example.com/feed.csv.gz", "network": "awin", "refreshHours": 6, "columns": { "name": "product_name", "price": "price", "currency": "currency", "url": "deep_link" } } ] }

• `networks` — Your affiliate account details by network name (used to build tracked links)
• `feeds` — Product data sources: CSV or JSON, local file path or URL, .gz automatically handled
• `columns` — Maps your feed's column names to DealFinder's expected fields

Security: Feed URLs often contain API keys. Keep them in dealfinder.config.json, never commit to version control.

---

Supported Networks

Derive a Link Template (for CJ, Impact, etc.)

Not sure about your network's link format? Generate one test link in your network's dashboard, then run:

npm run link-template -- --link "<generated link>" --url "<product URL>" --name mynetwork

It extracts your IDs, replaces the destination with {urlEncoded}, prints the networks config entry, and verifies by rebuilding your link.

Graceful Fallback

If a tracked link cannot be built (missing account config or placeholder), DealFinder returns the plain merchant URL and marks it tracked: false. You never get a broken link.

Validate Before Connecting

DEALFINDER_CONFIG=$PWD/dealfinder.config.json npm run check

Loads every feed and reports:

• Product counts and field coverage
• Price ranges and currency distribution
• Sample links (tracked and plain)
• Configuration errors that would prevent tracking

---

Compliance — Please Read

Legal Requirements

• ✅ Use official feeds/APIs only. Scraping violates most networks' terms of service.
• ✅ Check each program's terms before use, including whether AI-assisted promotion is allowed.
• ✅ Use your own affiliate IDs on your own traffic. Networks attribute sales to the publisher who referred the visitor — do not rotate or share IDs.
• ❌ Do not buy through your own affiliate links. Most programs forbid self-referral.
• ✅ Keep the disclosure visible next to affiliate links. DealFinder includes disclosure text with every tracked link — make sure your AI shows it.

Dat