This server exposes the FlexOffers affiliate marketing API (v3) as MCP tools, enabling you to manage affiliate programs, products, promotions, and earnings from AI clients like Claude Desktop, Cursor, or Windsurf.
Browse Advertiser Programs – List, search, and filter affiliate programs by name, category, country, or approval status (fo_list_advertisers, fo_get_featured_advertisers)
Explore Categories – Retrieve all advertiser categories for filtering (fo_get_categories)
Find Promotions & Coupons – Fetch active coupons and promotions filtered by advertiser, category, date range, discount amount, or promo type (fo_list_promotions, fo_get_promotion_types)
Search Products – Search by name, brand, UPC/EAN, or catalog ID with lightweight or full detail responses (fo_search_products, fo_search_products_full, fo_list_catalogs, fo_count_products)
Generate Affiliate Deep Links – Monetize any merchant URL with a tracked affiliate link (fo_generate_deeplink)
Browse Credit Card Offers – List financial card offers filtered by network, credit rating, or advertiser (fo_list_cards)
Track Earnings & Payments – View payout summaries and per-advertiser breakdowns for any date range (fo_get_payment_summary, fo_get_payment_details)
Analyze & Export Reports – List sales with status/date filters, or export performance reports (clicks, approved/pending sales) as CSV, Excel, or XML (fo_list_all_sales, fo_export_report)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@flexoffers-mcp list my approved advertisers in electronics"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server para la API de FlexOffers v3. Expone los endpoints más útiles como tools para Claude Desktop, Cursor, Windsurf, o cualquier cliente compatible con MCP.
cd flexoffers-mcp
npm install
npm run buildRelated MCP server: Refgrow MCP Server
Edita ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"flexoffers": {
"command": "node",
"args": ["/ruta/absoluta/a/flexoffers-mcp/dist/index.js"],
"env": {
"FLEXOFFERS_API_KEY": "tu_api_key_aqui"
}
}
}
}Agrega al archivo de configuración MCP del IDE:
{
"mcpServers": {
"flexoffers": {
"command": "node",
"args": ["/ruta/absoluta/a/flexoffers-mcp/dist/index.js"],
"env": {
"FLEXOFFERS_API_KEY": "tu_api_key_aqui"
}
}
}
}FLEXOFFERS_API_KEY=xxx npm run devTool | Descripción |
| Lista/busca programas de afiliados con filtros |
| Obtiene todas las categorías |
| Anunciantes destacados |
| Cupones y promociones activas |
| Tipos de promoción disponibles |
| Busca productos en el catálogo |
| Productos con datos completos (precio, descuentos) |
| Lista catálogos de productos disponibles |
| Cuenta productos antes de un pull masivo |
| Genera un link de afiliado monetizado |
| Ofertas de tarjetas de crédito |
| Resumen de pagos por periodo |
| Detalle de pagos por anunciante |
| Lista ventas de |
| Exporta reporte de clicks o ventas (CSV) |
¿Cuáles son mis advertisers aprobados en la categoría de electrónicos?
→ usa fo_list_advertisers con ProgramStatus=Approved
Dame los mejores cupones activos de hoy
→ usa fo_list_promotions con couponsOnly=true y startDate de hoy
Genera un deeplink para https://amazon.com/producto/123
→ usa fo_generate_deeplink
¿Cuánto gané en marzo 2026?
→ usa fo_get_payment_summary con startdate=03/01/2026 enddate=03/31/2026
Trae las ventas de ayer con detalle de productos
→ usa fo_list_all_sales con status=all, reportType=details, startDate=07/16/2026, endDate=07/16/2026, dateType=eventDate, page=1, pageSize=500Count products for a given catalog or filter before doing a full pull.
Inputs: cid, name, manufacturer.
Export a performance report (clicks, approved sales, pending sales) for a date range. Returns CSV data as text.
Inputs: EndDate (required), StartDate (required), ReportType (required), ReportFormat.
Generate a monetized FlexOffers deep link for any merchant URL. Returns the affiliate tracking URL.
Inputs: url (required), linkType, advertiserId.
Get all FlexOffers advertiser categories (for building filter UIs).
Inputs: no named parameters.
Get featured/promoted advertiser programs.
Inputs: page, Country, pageSize, categoryIds.
Get detailed payout breakdown by advertiser for a date range.
Inputs: enddate (required), startdate (required), page, pageSize.
Get payout summary for a date range. Returns total commissions earned.
Inputs: enddate (required), startdate (required).
Get all promotion type categories (banner, coupon, sale, etc.) with their IDs.
Inputs: no named parameters.
List or search advertiser programs. Filter by approval status, category, country, or name. Returns program details including commission rates and tracking links.
Inputs: Name, page, Country, pageSize, +4 more.
List financial card offers (credit cards, rewards cards) from FlexOffers.
Inputs: page, pageSize, isFeatured, categoryIds, +4 more.
List all product catalogs you have access to. Returns catalog IDs (cid) needed for product searches.
Inputs: page, pageSize.
Fetch active promotions and coupons from FlexOffers. Filter by advertiser, category, promo type, or date range. Use couponsOnly=true for coupon codes only.
Inputs: page, names, endDate, pageSize, +7 more.
Search FlexOffers product catalog. Requires at least one of: cid (catalog ID), name, manufacturer, or UPCorEANs. Returns lightweight product rows.
Inputs: MPN, cid, name, page, +6 more.
Search FlexOffers product catalog with full details including discounts and sale flags. Slower than fo_search_products but richer data.
Inputs: cid, name, page, Country, +4 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 14 tools
Each tool serves a distinct purpose: counting vs. searching products, listing vs. getting details, reports vs. payment summaries. No two tools have overlapping functionality.
All tools use a consistent 'fo_' prefix followed by a clear verb_noun pattern (e.g., count_products, export_report, generate_deeplink, get_categories). The pattern is uniform and predictable.
With 14 tools covering key areas like products, reports, payments, promotions, and advertisers, the count is well-scoped for the FlexOffers affiliate domain—neither too sparse nor overloaded.
The tool set comprehensively covers the primary operations: product search/count, advertiser listing, link generation, report export, payment details, promotions, and categories. No obvious gaps for standard affiliate tasks.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Hosted MCP server for 3Dsellers, the multichannel selling platform. Connect Claude, ChatGPT, Cursor, VS Code or any MCP client and manage your eBay, Amazon, Walmart, Etsy, Shopify, WooCommerce and TikTok Shop stores in plain language: search and update products, publish listings, sync inventory, tag and track orders, run bulk actions and CSV imports, and reply to customer messages. 120+ tools. Sign in with OAuth or a personal token. No eBay developer account and nothing to install. Setup guides and config examples for every client: https://github.com/3dsellers/ebay-mcp-server
