ClickBank MCP Server

Servidor Stdio del Model Context Protocol para ClickBank REST 1.3. Cursor y otros hosts MCP pueden consultar analytics, pedidos, productos, quickstats, envíos y tickets. Las operaciones de escritura (reembolsos, edición de catálogo, cambios de suscripción) están desactivadas a menos que optes por activarlas.

Configuración

1. Crea una clave de API en ClickBank: Cómo crear claves de API de ClickBank.

2. Concede a la clave los roles que necesites (api_order_read, api_products_client, api_order_write, api_subscription_modifications, etc.).

3. Copia .env.example y rellena los valores (el servidor lee las variables de entorno del proceso, no el archivo, salvo que tu host las inyecte).

npm install
npm run build

Entorno requerido:

ClickBank ya no requiere una clave de desarrollador. No registres ni hagas commit de la cabecera Authorization.

Related MCP server: wealthbox-mcp

Cursor

Compila primero y luego apunta Cursor a dist/index.js:

{
  "mcpServers": {
    "clickbank": {
      "command": "node",
      "args": ["/absolute/path/to/clickbank-mcp/dist/index.js"],
      "env": {
        "CLICKBANK_API_KEY": "API-your-key-here",
        "CLICKBANK_ACCOUNT": "yournick",
        "CLICKBANK_ENABLE_WRITES": "false"
      }
    }
  }
}

Mantén CLICKBANK_ENABLE_WRITES en false a menos que quieras que el modelo pueda hacer reembolsos, eliminar productos o cambiar suscripciones.

Herramientas

Las herramientas de lectura siempre están registradas:

• Analytics: get_analytics, get_subscription_analytics

• Orders: list_orders, count_orders, get_order, get_order_upsells, check_order_active

• Products: list_products, get_product

• Quickstats: list_quickstats, summarize_quickstats, list_clickbank_accounts

• Envíos: list_shippable_orders, count_shippable_orders, get_ship_notices

• Tickets: list_tickets, count_tickets, get_ticket, get_refund_amounts

Herramientas de escritura (solo cuando CLICKBANK_ENABLE_WRITES=true):

• modify_subscription — intercambio de producto, dirección, fecha de renovación, ampliación, pausa, restablecimiento

• save_product, delete_product

• create_ship_notice

• create_ticket, update_ticket, confirm_physical_return

Los endpoints de listado devuelven 100 filas por página. Pasa page y, opcionalmente, maxPages (máx. 10). HTTP 206 indica que quedan más páginas. El cliente espacia las peticiones (~8/s) para mantenerse por debajo de la cuota de 10 peticiones/segundo de ClickBank.

Desarrollo

npm test
npm run dev

npm run dev sigue necesitando CLICKBANK_API_KEY en el entorno. Las pruebas simulan fetch y no llaman a ClickBank.