UpPromote MCP Server

UpPromote

UpPromote runs affiliate programs for e-commerce stores. Affiliates refer customers; referrals track conversions and commissions; coupons are affiliate-specific discount codes assigned from your store catalog.

Data Model

• Affiliates — partner accounts with program membership, status, contact fields, and affiliate links.
• Referrals — order-level conversion rows with commission, status (pending, approved, paid, denied), and nested affiliate contact.
• Coupons — coupon codes assigned to affiliates (not the Shopify discount definition itself).

Operational order

1. List affiliates to discover ids, emails, and program membership before writes.
2. List referrals with status or date filters when auditing commissions or payout readiness.
3. List coupons filtered by affiliate_id when verifying code assignments.
4. Create affiliates or assign coupons only on explicit user intent — both mutate live program data.

Gotchas

• Store-scoped: Each API key belongs to one UpPromote-connected store; results never cross shops.
• Pagination: List endpoints use page and limit (max 100 per call). Default to modest page sizes on large programs.
• Affiliate search: Name or email lookup uses the dedicated search route — pass q when keyword matching instead of scanning full pages.
• Create-only writes: The public API supports creating affiliates and assigning coupons. Updates and deletes are admin-only — not on the MCP surface.
• Coupon cap: Each affiliate may hold at most 100 assigned coupon codes.
• Referral filters: status accepts pending, approved, paid, or denied; combine affiliate_id with from_date and to_date for payout windows.