ClickBank MCP Server
ClickBank MCP Server
ClickBank REST 1.3을 위한 Stdio Model Context Protocol 서버입니다. Cursor 및 기타 MCP 호스트는 애널리틱스, 주문, 상품, 퀵스탯, 배송, 티켓을 조회할 수 있습니다. 쓰기 작업(환불, 카탈로그 편집, 구독 변경)은 옵트인하지 않으면 꺼져 있습니다.
설정
ClickBank에서 API 키를 생성하세요: How to create ClickBank API keys.
키에 필요한 역할을 부여하세요(
api_order_read,api_products_client,api_order_write,api_subscription_modifications등)..env.example을 복사한 뒤 값을 입력하세요(서버는 파일이 아니라 프로세스 환경 변수를 읽습니다. 호스트가 주입하지 않는 한).
npm install
npm run build필수 환경 변수:
Variable | Purpose |
| Clerk 키. |
| 기본 닉네임(5~10자의 소문자 영숫자). 애널리틱스에 필수이며 퀵스탯의 기본값입니다. |
|
|
| 선택적인 레거시 개발자 키. 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_product퀵스탯:
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
목록 엔드포인트는 페이지당 100행을 반환합니다. page와 선택적 maxPages(최대 10)를 전달하세요. HTTP 206은 더 많은 페이지가 남아 있음을 의미합니다. 클라이언트는 ClickBank의 초당 10회 요청 할당량을 지키기 위해 요청 간격(~8/s)을 둡니다.
개발
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