Skip to main content
Glama

ClickBank MCP Server

ClickBank REST 1.3을 위한 Stdio Model Context Protocol 서버입니다. Cursor 및 기타 MCP 호스트는 애널리틱스, 주문, 상품, 퀵스탯, 배송, 티켓을 조회할 수 있습니다. 쓰기 작업(환불, 카탈로그 편집, 구독 변경)은 옵트인하지 않으면 꺼져 있습니다.

설정

  1. ClickBank에서 API 키를 생성하세요: How to create ClickBank API keys.

  2. 키에 필요한 역할을 부여하세요(api_order_read, api_products_client, api_order_write, api_subscription_modifications 등).

  3. .env.example을 복사한 뒤 값을 입력하세요(서버는 파일이 아니라 프로세스 환경 변수를 읽습니다. 호스트가 주입하지 않는 한).

npm install
npm run build

필수 환경 변수:

Variable

Purpose

CLICKBANK_API_KEY

Clerk 키. API- 접두사를 포함합니다.

CLICKBANK_ACCOUNT

기본 닉네임(5~10자의 소문자 영숫자). 애널리틱스에 필수이며 퀵스탯의 기본값입니다.

CLICKBANK_ENABLE_WRITES

true로 설정하면 환불, 상품, 배송 통지, 구독 도구를 등록합니다.

CLICKBANK_DEV_KEY

선택적인 레거시 개발자 키. Authorization 헤더는 DEV-…:API-…가 됩니다.

CLICKBANK_BASE_URL

API 루트를 재정의합니다(기본값 https://api.clickbank.com/rest/1.3).

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_product

  • create_ship_notice

  • create_ticket, update_ticket, confirm_physical_return

목록 엔드포인트는 페이지당 100행을 반환합니다. page와 선택적 maxPages(최대 10)를 전달하세요. HTTP 206은 더 많은 페이지가 남아 있음을 의미합니다. 클라이언트는 ClickBank의 초당 10회 요청 할당량을 지키기 위해 요청 간격(~8/s)을 둡니다.

개발

npm test
npm run dev

npm run dev는 여전히 환경에 CLICKBANK_API_KEY가 필요합니다. 테스트는 fetch를 모킹하며 ClickBank를 호출하지 않습니다.

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