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