CJ MCP Server

MCP (Model Context Protocol) server for the CJ.com (Commission Junction) affiliate network API.

Live endpoint: https://cj.mcp.ottolax.com/mcp Health check: https://cj.mcp.ottolax.com/health

Connection

Add to your MCP client config:

{
  "mcpServers": {
    "cj": {
      "type": "http",
      "url": "https://cj.mcp.ottolax.com/mcp"
    }
  }
}

After connecting, call cj_set_credentials first with your Personal Access Token and Company CID. Get your token at developers.cj.com/account/personal-access-tokens.

cj_set_credentials(
  personalAccessToken: "your-token-here",
  companyCid: "1234567"
)

Tools (16 total)

Auth

| Tool | Description | |------|-------------| | cj_set_credentials | Set Personal Access Token + Company CID. Must be called first. |

Publisher Tools

| Tool | Description | |------|-------------| | cj_publisher_commissions | Get commission records for publishers (GraphQL). Supports cursor pagination, date ranges, status/type filters. | | cj_get_program_terms | Get commission structures and rates for joined advertiser programs. | | cj_get_promotional_properties | List publisher websites/PIDs for a company. | | cj_create_promotional_property | Create a new publisher website/PID. | | cj_update_promotional_property | Update an existing publisher website/PID. | | cj_search_products | Search products available to promote via Product Feed API. | | cj_lookup_advertisers | Find advertisers to join (REST, returns XML). | | cj_search_links | Search for affiliate links, banners, coupons (REST, returns XML). | | cj_get_automated_offer_feed | Get credit card offer feeds from financial advertisers (REST, returns XML). | | cj_legacy_get_commissions | (Deprecated) Legacy commission detail via REST API. | | cj_legacy_get_item_detail | (Deprecated) Item-level detail for advanced sale commissions. |

Advertiser Tools

| Tool | Description | |------|-------------| | cj_advertiser_commissions | Get commission records for advertisers (GraphQL). | | cj_create_orders | Submit new orders/conversions for tracking (max 10,000/batch). | | cj_restate_orders | Correct/update previously submitted orders. | | cj_cancel_orders | Cancel previously submitted orders. | | cj_lookup_publishers | Find publishers joined to your program (REST, returns XML). | | cj_upsert_enroll_publisher | Enroll influencers/publishers into programs (Tech Partner API). |

Recommended Agent Setup

Use specialized agents for each domain — they handle their slice of the API independently.

1. cj-commissions-agent — Commission Reporting

Role: Query, reconcile, and export commission data. Tools: cj_set_credentials, cj_publisher_commissions, cj_advertiser_commissions, cj_legacy_get_commissions, cj_legacy_get_item_detail

Prompt:

You are a CJ affiliate commissions analyst. You have access to the CJ MCP server.
Always call cj_set_credentials first. Then use cj_publisher_commissions or
cj_advertiser_commissions to fetch commission data. Handle pagination using
sinceCommissionId when payloadComplete is false. Present results as structured
tables with totals. Flag any locked or closed commissions separately.

Use for:

• Daily/weekly commission reports
• Reconciling expected vs. received commissions
• Exporting data to spreadsheets
• Tracking commission status changes (new → locked → closed)

2. cj-publisher-agent — Publisher & Property Management

Role: Manage publisher websites, PIDs, and program terms. Tools: cj_set_credentials, cj_get_promotional_properties, cj_create_promotional_property, cj_update_promotional_property, cj_get_program_terms

Prompt:

You are a CJ publisher account manager. You have access to the CJ MCP server.
Always call cj_set_credentials first. Manage promotional properties (publisher
websites/PIDs) and retrieve program terms showing commission rates. When creating
properties, confirm the type, URL, and categories before submitting.

Use for:

• Adding new websites/PIDs to a publisher account
• Reviewing commission rates for joined programs
• Auditing active vs. inactive promotional properties

3. cj-advertiser-agent — Advertiser & Order Tracking

Role: Submit, restate, and cancel orders; manage publisher relationships. Tools: cj_set_credentials, cj_create_orders, cj_restate_orders, cj_cancel_orders, cj_lookup_publishers

Prompt:

You are a CJ advertiser account manager. You have access to the CJ MCP server.
Always call cj_set_credentials first. Use testMode: true when testing order
submissions. Batch orders up to 10,000 per request. Always confirm order details
before submitting. For restates, explain what changed and why.

Use for:

• Server-to-server (S2S) order submission
• Correcting misfired or wrong-amount orders
• Cancelling fraudulent or returned orders
• Looking up joined publishers

4. cj-content-agent — Links, Products & Offers

Role: Find and surface affiliate links, banners, products, and promotional offers. Tools: cj_set_credentials, cj_search_links, cj_search_products, cj_lookup_advertisers, cj_get_automated_offer_feed

Prompt:

You are a CJ affiliate content specialist. You have access to the CJ MCP server.
Always call cj_set_credentials first. Search for links and products to embed in
content. Prefer joined advertisers unless explicitly told otherwise. Parse XML
responses and return clean structured data. For credit card offers, use
cj_get_automated_offer_feed with the specific advertiser ID.

Use for:

• Finding banner ads and text links for blog posts
• Product feed searches for shopping content
• Pulling coupon/promo codes by advertiser
• Credit card comparison content via automated offer feed

5. cj-enrollment-agent — Tech Partner / Influencer Enrollment

Role: Enroll publishers and influencers into CJ programs at scale. Tools: cj_set_credentials, cj_upsert_enroll_publisher

Prompt:

You are a CJ tech partner enrollment specialist. You have access to the CJ MCP server.
Always call cj_set_credentials first. Use cj_upsert_enroll_publisher to onboard
influencers into CJ programs. Validate that email, name, websiteUrl, and
advertiserIds are all provided before calling. Report enrollment status for each
advertiser ID after submission.

Use for:

• Bulk influencer onboarding into affiliate programs
• Automatically enrolling new creators into brand programs
• Syncing influencer rosters from external platforms into CJ

Rate Limits

| API | Limit | |-----|-------| | GraphQL (commissions, program terms) | 200 calls / 5 minutes | | REST (link search, advertiser/publisher lookup) | 25 calls / minute | | Tracking API (order submission) | Max 10,000 orders / batch | | Commission date range | Max 31 days per query |

API Reference

Full CJ API documentation: developers.cj.com

| Endpoint | Type | Used By | |----------|------|---------| | commissions.api.cj.com/query | GraphQL | cj_publisher_commissions, cj_advertiser_commissions | | programs.api.cj.com/query | GraphQL | cj_get_program_terms | | accounts.api.cj.com/graphql | GraphQL | cj_get/create/update_promotional_property | | product-search.api.cj.com/v2/product-search | GraphQL | cj_search_products | | graph.cj.com/techpartners | GraphQL | cj_upsert_enroll_publisher | | tracking.api.cj.com/graphql | GraphQL | cj_create/restate/cancel_orders | | advertiser-lookup.api.cj.com/v2/advertiser-lookup | REST (XML) | cj_lookup_advertisers | | publisher-lookup.api.cj.com/v2/joined-publisher-lookup | REST (XML) | cj_lookup_publishers | | link-search.api.cj.com/v2/link-search | REST (XML) | cj_search_links, cj_get_automated_offer_feed | | commission-detail.api.cj.com/v3/commissions | REST (XML, deprecated) | cj_legacy_get_commissions | | commission-detail.api.cj.com/v3/item-detail/{id} | REST (XML, deprecated) | cj_legacy_get_item_detail |