Flexoffers

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.

Instalación

cd flexoffers-mcp
npm install
npm run build

Configuración

Claude Desktop

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"
      }
    }
  }
}

Cursor / Windsurf

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"
      }
    }
  }
}

Dev (sin compilar)

FLEXOFFERS_API_KEY=xxx npm run dev

Tools disponibles

Tool	Descripción
fo_list_advertisers	Lista/busca programas de afiliados con filtros
fo_get_categories	Obtiene todas las categorías
fo_get_featured_advertisers	Anunciantes destacados
fo_list_promotions	Cupones y promociones activas
fo_get_promotion_types	Tipos de promoción disponibles
fo_search_products	Busca productos en el catálogo
fo_search_products_full	Productos con datos completos (precio, descuentos)
fo_list_catalogs	Lista catálogos de productos disponibles
fo_count_products	Cuenta productos antes de un pull masivo
fo_generate_deeplink	Genera un link de afiliado monetizado
fo_list_cards	Ofertas de tarjetas de crédito
fo_get_payment_summary	Resumen de pagos por periodo
fo_get_payment_details	Detalle de pagos por anunciante
fo_export_report	Exporta reporte de clicks o ventas (CSV)

Ejemplos de uso (en Claude)

¿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