ClickBank MCP Server
ClickBank MCP Server
Stdio Model Context Protocol サーバー(ClickBank REST 1.3 用)です。Cursor やその他の MCP ホストは、アナリティクス、注文、商品、Quickstats、配送、チケットを照会できます。書き込み操作(返金、カタログ編集、サブスクリプション変更)は、オプトインしない限り無効です。
セットアップ
ClickBank で API キーを作成します: ClickBank API キーの作成方法。
キーに必要なロールを付与します(
api_order_read、api_products_client、api_order_write、api_subscription_modificationsなど)。.env.exampleをコピーして値を入力します(サーバーが読み取るのはファイルではなくプロセス環境変数です。ホストが注入する場合を除きます)。
npm install
npm run build必須環境変数:
変数 | 目的 |
| Clerk キー( |
| デフォルトのニックネーム(5〜10文字の小文字英数字)。アナリティクスに必須。Quickstats のデフォルト |
|
|
| オプションのレガシー開発者キー。Authorization は |
| API ルートを上書き(デフォルトは |
ClickBank はもはや開発者キーを必要としません。Authorization ヘッダーをログに記録したり、コミットしたりしないでください。
Related MCP server: amazon-mcp
Cursor
まずビルドしてから、Cursor に 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"
}
}
}
}モデルに返金、商品の削除、サブスクリプションの変更をさせたい場合を除き、CLICKBANK_ENABLE_WRITES は false のままにしてください。
ツール
読み取りツールは常に登録されます:
アナリティクス:
get_analytics、get_subscription_analytics注文:
list_orders、count_orders、get_order、get_order_upsells、check_order_active商品:
list_products、get_productQuickstats:
list_quickstats、summarize_quickstats、list_clickbank_accounts配送:
list_shippable_orders、count_shippable_orders、get_ship_noticesチケット:
list_tickets、count_tickets、get_ticket、get_refund_amounts
書き込みツール(CLICKBANK_ENABLE_WRITES=true の場合のみ):
modify_subscription— 商品の交換、住所、再請求日、延長、一時停止、復元save_product、delete_productcreate_ship_noticecreate_ticket、update_ticket、confirm_physical_return
一覧系エンドポイントは 1 ページあたり 100 行を返します。page とオプションの maxPages(最大 10)を渡します。HTTP 206 は、まだページが残っていることを意味します。クライアントは、ClickBank の毎秒 10 リクエストのクォータ内に収まるよう、リクエストの間隔を空けます(約 8/秒)。
開発
npm test
npm run devnpm run dev でも環境内に CLICKBANK_API_KEY が必要です。テストは fetch をモックし、ClickBank を呼び出しません。
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