ClickBank MCP Server
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
Erstellen Sie einen API-Schlüssel in ClickBank: So erstellen Sie ClickBank-API-Schlüssel.
Erteilen Sie dem Schlüssel die benötigten Rollen (
api_order_read,api_products_client,api_order_write,api_subscription_modificationsusw.).Kopieren Sie
.env.exampleund 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 buildErforderliche Umgebungsvariablen:
Variable | Zweck |
| Clerk-Schlüssel, einschließlich des Präfixes |
| Standard-Nickname (5–10 Kleinbuchstaben und Ziffern). Erforderlich für Analysen; Standard für Quickstats |
| Auf |
| Optionaler Legacy-Entwicklerschlüssel; der Authorization-Header wird zu |
| API-Basis-URL überschreiben (Standard: |
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_analyticsBestellungen:
list_orders,count_orders,get_order,get_order_upsells,check_order_activeProdukte:
list_products,get_productQuickstats:
list_quickstats,summarize_quickstats,list_clickbank_accountsVersand:
list_shippable_orders,count_shippable_orders,get_ship_noticesTickets:
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, Reaktivierungsave_product,delete_productcreate_ship_noticecreate_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 devnpm run dev benötigt weiterhin CLICKBANK_API_KEY in der Prozessumgebung. Die Tests mocken fetch und rufen ClickBank nicht auf.
Available Tools
19 toolscheck_order_activeCheck if a ClickBank order is activeARead-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 ordersBRead-only
Count orders matching the same filters as list_orders.
Inputs: tid, item, role, type, +8 more.
count_shippable_ordersCount shippable ClickBank ordersBRead-only
Count physical-goods orders matching shipping filters.
Inputs: days, page, status, endDate, +3 more.
count_ticketsCount ClickBank ticketsARead-only
Count tickets by type, status, or receipt.
Inputs: type, status, receipt.
get_analyticsGet ClickBank analyticsBRead-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 orderBRead-only
Get order details for a receipt ID.
Inputs: receipt (required).
get_order_upsellsGet ClickBank order upsellsARead-only
List upsell transactions for a parent receipt.
Inputs: receipt (required).
get_productGet a ClickBank productARead-only
Get one product by SKU and site nickname.
Inputs: sku (required), site (required).
get_refund_amountsGet ClickBank refund amountsARead-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 noticesARead-only
Get shipping notices already filed for a receipt.
Inputs: receipt (required).
get_subscription_analyticsGet ClickBank subscription analyticsCRead-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 ticketARead-only
Get one ticket by ID.
Inputs: id (required).
list_clickbank_accountsList ClickBank account nicknamesARead-only
List account nicknames the current API key can read.
Inputs: no named parameters.
list_ordersList ClickBank ordersBRead-only
List orders matching date, type, vendor, affiliate, email, or tracking filters.
Inputs: tid, item, page, role, +10 more.
list_productsList ClickBank productsARead-only
List products for a site nickname. Optionally filter STANDARD or RECURRING.
Inputs: site (required), type.
list_quickstatsList ClickBank quickstatsBRead-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 ordersARead-only
List physical-goods orders by shipped status, date range, or receipt.
Inputs: days, page, status, endDate, +3 more.
list_ticketsList ClickBank ticketsARead-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 quickstatsARead-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
Scored across 19 tools
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.
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.
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.
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
Related MCP Connectors
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Discover, plan and run tools across your connected business systems through one OAuth MCP endpoint
MCP server for SkuVault — products, inventory, sales, purchase orders and stock adjustments.
Related MCP Servers
- FlicenseBqualityCmaintenanceEnables retrieval of customer records and triggering refunds via MCP tools, supporting both stdio and streamable HTTP transports.2-
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceConnects 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
- AlicenseNot gradedqualityCmaintenanceEnables 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.2MIT