Feedico

Open source · MCP · MIT license

Feedico AI Coupon Agent

Ask Cursor or Claude for live affiliate merchants and promo codes — in plain English or your language. Powered by Feedico and the Model Context Protocol.

View on GitHubGet Feedico accountArchitecture guide

What is it?

An MCP server that turns your AI IDE into a Feedico coupon agent. Instead of writing REST calls manually, you ask questions like:

  • “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. 100+ prompt examples on GitHub →

MCP tools

ToolPurpose
feedico_catalog_summaryTotals and connected affiliate networks in your account
feedico_list_merchantsStores / merchants with pagination and filters
feedico_list_couponsCoupon codes and deals from synced programmes

Built-in MCP prompts

In Cursor: MCP → Prompts

  • feedico_catalog_summary
  • feedico_list_merchants
  • feedico_list_coupons
  • feedico_merchants_by_network
  • feedico_coupons_for_store

Quick start

  1. Clone the repo and install dependencies:
    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/dashboard
npm install
  2. Add to Cursor ~/.cursor/mcp.json (use absolute paths on your machine):
    {
  "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 API token in .env only — never in mcp.json.

  3. Restart Cursor → Settings → Tools & MCP → confirm feedico is connected (green).

Example questions

English

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

Other languages

Ask in Turkish, German, French, Spanish, or any language you prefer. The assistant replies in the language you used — the MCP layer still reads live data from your Feedico catalogue.

Security

Related open-source projects

feedico-wp-plugin

WordPress sync

feedico-api-node-example

Node.js API

feedico-api-python-example

Python API

feedico-api-php-example

PHP API

feedico-etl-starter

ETL warehouse

feedico-api-postman

Postman collection

FAQ

What is the Feedico AI Coupon Agent?
It is an open-source Model Context Protocol (MCP) server that connects Cursor, Claude Desktop, or any MCP client to your Feedico account. You ask questions in natural language; the server calls Feedico's REST API and returns live merchant and coupon data.
Do I need a Feedico account?
Yes. Sign up at feedico.io, connect at least one affiliate network, wait for sync, then copy your API token (fdco_…) into the project's .env file. The MCP server never stores credentials in mcp.json.
Does it work in languages other than English?
Yes. Documentation and MCP prompts default to English, but you can ask in Turkish, German, French, Spanish, and other languages. The assistant typically replies in the language you used.
How is this different from the Coupon API for AI agents guide?
The guide at /coupon-api-for-ai-agents explains architecture patterns for any agent framework. This MCP server is a ready-to-install implementation — clone, configure, and use in Cursor without writing tool wrappers yourself.
Is the MCP server read-only?
Yes. Tools list catalogue data only. They do not modify your Feedico dashboard, networks, or credentials beyond normal API reads.