Skip to main content
Glama

ClickBank MCP Server

Ein Stdio-Model Context Protocol-Server für ClickBank REST 1.3. Cursor und andere MCP-Hosts können Analysen, Bestellungen, Produkte, Quickstats, Versand und Tickets abfragen. Schreiboperationen (Erstattungen, Katalogänderungen, Abonnementänderungen) sind deaktiviert, sofern Sie sie nicht aktivieren.

Einrichtung

  1. Erstellen Sie einen API-Schlüssel in ClickBank: So erstellen Sie ClickBank-API-Schlüssel.

  2. Erteilen Sie dem Schlüssel die benötigten Rollen (api_order_read, api_products_client, api_order_write, api_subscription_modifications usw.).

  3. Kopieren Sie .env.example und füllen Sie die Werte aus (der Server liest die Prozessumgebung, nicht die Datei, es sei denn, Ihr Host injiziert sie).

npm install
npm run build

Erforderliche Umgebungsvariablen:

Variable

Zweck

CLICKBANK_API_KEY

Clerk-Schlüssel, einschließlich des Präfixes API-

CLICKBANK_ACCOUNT

Standard-Nickname (5–10 Kleinbuchstaben und Ziffern). Erforderlich für Analysen; Standard für Quickstats

CLICKBANK_ENABLE_WRITES

Auf true setzen, um Erstattungs-, Produkt-, Versandmitteilungs- und Abonnement-Werkzeuge zu registrieren

CLICKBANK_DEV_KEY

Optionaler Legacy-Entwicklerschlüssel; der Authorization-Header wird zu DEV-…:API-…

CLICKBANK_BASE_URL

API-Basis-URL überschreiben (Standard: https://api.clickbank.com/rest/1.3)

ClickBank verlangt keinen Entwicklerschlüssel mehr. Der Authorization-Header darf weder protokolliert noch committet werden.

Related MCP server: amazon-mcp

Cursor

Führen Sie zuerst den Build aus und verweisen Sie Cursor dann auf 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"
      }
    }
  }
}

Lassen Sie CLICKBANK_ENABLE_WRITES auf false, außer Sie möchten, dass das Modell Erstattungen durchführen, Produkte löschen oder Abonnements ändern kann.

Werkzeuge

Lese-Werkzeuge sind immer registriert:

  • Analysen: get_analytics, get_subscription_analytics

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

  • Produkte: list_products, get_product

  • Quickstats: list_quickstats, summarize_quickstats, list_clickbank_accounts

  • Versand: list_shippable_orders, count_shippable_orders, get_ship_notices

  • Tickets: list_tickets, count_tickets, get_ticket, get_refund_amounts

Schreib-Werkzeuge (nur wenn CLICKBANK_ENABLE_WRITES=true):

  • modify_subscription — Produkttausch, Adresse, Folgeabrechnungsdatum, Verlängerung, Pausierung, Reaktivierung

  • save_product, delete_product

  • create_ship_notice

  • create_ticket, update_ticket, confirm_physical_return

Listen-Endpunkte geben 100 Zeilen pro Seite zurück. Übergeben Sie page und optional maxPages (maximal 10). HTTP 206 bedeutet, dass noch weitere Seiten vorhanden sind. Der Client drosselt die Anfragen (~8/s), um unter ClickBanks Limit von 10 Anfragen pro Sekunde zu bleiben.

Entwicklung

npm test
npm run dev

npm run dev benötigt weiterhin CLICKBANK_API_KEY in der Prozessumgebung. Die Tests mocken fetch und rufen ClickBank nicht auf.

Available Tools

19 tools
check_order_activeCheck if a ClickBank order is activeA
Read-only

HEAD a receipt: active=true if the order is not refunded, charged back, or canceled. 403 is returned as active=false (also used when the receipt is missing or inaccessible).

Inputs: receipt (required).

count_ordersCount ClickBank ordersB
Read-only

Count orders matching the same filters as list_orders.

Inputs: tid, item, role, type, +8 more.

count_shippable_ordersCount shippable ClickBank ordersB
Read-only

Count physical-goods orders matching shipping filters.

Inputs: days, page, status, endDate, +3 more.

count_ticketsCount ClickBank ticketsA
Read-only

Count tickets by type, status, or receipt.

Inputs: type, status, receipt.

get_analyticsGet ClickBank analyticsB
Read-only

Fetch vendor or affiliate analytics by dimension (product, country, tracking id, etc.). Set summarize=true for totals.

Inputs: role (required), dimension (required), page, select, +10 more.

get_orderGet ClickBank orderB
Read-only

Get order details for a receipt ID.

Inputs: receipt (required).

get_order_upsellsGet ClickBank order upsellsA
Read-only

List upsell transactions for a parent receipt.

Inputs: receipt (required).

get_productGet a ClickBank productA
Read-only

Get one product by SKU and site nickname.

Inputs: sku (required), site (required).

get_refund_amountsGet ClickBank refund amountsA
Read-only

Preview how a FULL, PARTIAL_PERCENT, or PARTIAL_AMOUNT refund converts in the customer's currency.

Inputs: receipt (required), refundType (required), sku, refundAmount.

get_ship_noticesGet ClickBank ship noticesA
Read-only

Get shipping notices already filed for a receipt.

Inputs: receipt (required).

get_subscription_analyticsGet ClickBank subscription analyticsC
Read-only

Fetch subscription details or trends. view selects the ClickBank report (details, next_payment, cancel windows, by_status, trends).

Inputs: role (required), view (required), page, status, +8 more.

get_ticketGet a ClickBank ticketA
Read-only

Get one ticket by ID.

Inputs: id (required).

list_clickbank_accountsList ClickBank account nicknamesA
Read-only

List account nicknames the current API key can read.

Inputs: no named parameters.

list_ordersList ClickBank ordersB
Read-only

List orders matching date, type, vendor, affiliate, email, or tracking filters.

Inputs: tid, item, page, role, +10 more.

list_productsList ClickBank productsA
Read-only

List products for a site nickname. Optionally filter STANDARD or RECURRING.

Inputs: site (required), type.

list_quickstatsList ClickBank quickstatsB
Read-only

Daily sale, refund, and chargeback totals for an account and date range.

Inputs: page, account, endDate, maxPages, +1 more.

list_shippable_ordersList shippable ClickBank ordersA
Read-only

List physical-goods orders by shipped status, date range, or receipt.

Inputs: days, page, status, endDate, +3 more.

list_ticketsList ClickBank ticketsA
Read-only

Search support, cancel, and refund tickets. Date windows (create/update/close) cannot exceed 7 days.

Inputs: page, type, status, receipt, +7 more.

summarize_quickstatsSummarize ClickBank quickstatsA
Read-only

Sum sale, refund, and chargeback amounts for an account and date range.

Inputs: page, account, endDate, maxPages, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 19 tools

    Disambiguation3/5

    Most tools map cleanly to a distinct resource and action, but the analytics-related tools overlap: get_analytics, get_subscription_analytics, list_quickstats, and summarize_quickstats all offer sales/revenue metrics with fuzzy boundaries. list_orders and list_shippable_orders can also be confused when dealing with physical goods.

    Naming Consistency5/5

    Tool names consistently follow a verb_noun snake_case pattern using get_, list_, count_, summarize_, and check_. The conventions are predictable across all resource areas, making the toolset easy to navigate.

    Tool Count3/5

    19 tools is on the heavy side, especially since three count_* tools duplicate the filtering logic of their list_* counterparts rather than adding new capabilities. The count is still organized and justified by the broad ClickBank domain, but it feels slightly inflated.

    Completeness4/5

    Core query workflows are well covered: orders, products, tickets, shipping, subscriptions, analytics, and accounts all have reasonable read operations. The main gaps are the lack of write/update operations and a dedicated refund transaction list, though agents can work around these via order filters and quickstats.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      C
      maintenance
      Enables retrieval of customer records and triggering refunds via MCP tools, supporting both stdio and streamable HTTP transports.
      2
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables sellers to interact with Amazon Selling Partner API and Advertising API data—orders, inventory, pricing, ads, reports, and more—through MCP clients like Claude and Cursor.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects Cursor and Grok Bot to authorized workspaces through MCP and OAuth, enabling read-only queries of workspace metrics, campaign results, conversion delivery status, WhatsApp tracking, and authorized lead or Inbox data.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to connect marketplace seller accounts, explore and call shop-level APIs, and manage orders, products, returns, inventory, pricing, and tracking with scoped read-only or read-write access.
      2
      MIT