Supported Tools

Learn what you can do with UpPromote's MCP Server via the tools we extend to AI agents.

Below are the tools an MCP client (Claude Code, Antigravity, VsCode, ...) can use to look up, analyze, and act on the affiliate marketing data in your UpPromote workspace.

With a single prompt you can ask "who are my top affiliates this month?", "how much commission is still pending?", or "approve all pending affiliates in the Summer program" — the AI picks the right tool (or chain of tools) to answer or act.

The tools split into 2 groups:

• Read Data: look up affiliates, programs, and referrals, get data about aggregated performance, rankings, and commission figures, or count a single total for a filter, without pulling the records.

• Write Action: approve or deny affiliates in bulk, always with your confirmation.

Note:

• These tools are subject to usage limits - 100 requests per minute per store and 15 concurrent requests globally. Read tools never change your data. Write tools change live data and always ask you to confirm before running.

• For security, the server allows up to 5 simultaneous connections per IP address. This only affects cases where multiple merchants on the same IP open more than 5 connections at once — rare in normal use.

Availability: This feature is available on the Professional plan and above.

Tools read (for Entity)

Look up affiliates, programs, and referrals. These tools never change your data.

Title	Tool Name	Description
List Affiliates	list_affiliates	List and filter the store's affiliates by status, program, sign-up date, or name/email — returns records with pagination.
Get Affiliate	get_affiliate	Get the full profile of one affiliate by id (contact info, program, total referrals and commission).
List Programs	list_program	List and filter the store's affiliate programs by attribute — e.g. active vs inactive, commission type.
Get Program	get_program	Get the full setup of one program by id (commission type and rate, cookie duration, rules, status).
List Referrals	list_referral	List and filter referrals (referred orders) by status, affiliate, program, tracking type, or date.
Get Referral	get_referral	Get the full detail of one referral order by id (products, sales, commission, conversion and tracking info).

Tools Read (for Analytics)

Aggregated numbers for the affiliate channel over a period. Scope to the whole channel, one program, or one affiliate.

Title	Tool Name	Description
Performance Data	get_performance_data	Get channel performance for a period: totals (affiliates, clicks, referral orders, sales, commission) and ratios (conversion rate, AOV, ROI, CAC).
Top Affiliates	get_top_affiliates	Rank affiliates by performance — best or worst performers by sales and commission.
Commission Breakdown	get_commission_breakdown	Get commission totals split by status for a period: pending, approved (unpaid), and paid, plus the total.
Referrals by Tracking Type	get_list_referrals_by_tracking_type	Get referral counts grouped by tracking type for a period: affiliate link, coupon, connected customers, connected products, and others.

Tools Read (for Count Total)

Return a single total for a filter — a number, not the records. Lighter than the matching list tool when you only need a count.

Title	Tool Name	Description
Total Affiliates	count_affiliates	Get the total number of affiliates matching a filter (same filters as List Affiliates).
Total Referrals	count_referrals	Get the total number of referrals matching a filter (same filters as List Referrals).
Total Programs	count_programs	Get the total number of programs matching a filter (same filters as List Programs).

Write Action

Approve or deny affiliate in bulk. This tool changes live data, sends emails to affiliates, and always shows you the list and asks for confirmation before running. Maximum 100 ids per call.

Title	Tool Name	Description
Review Affiliates	reviewAffiliate	Approve or deny one or more pending affiliate applications in bulk. Approve activates them (unverified affiliates still can't log in until they verify); deny rejects the application without deleting their data. Each affiliate is emailed.

How tools work together

The AI often chains tools to answer one question. A few common patterns:

• Name → id first. If you refer to an affiliate or program by name, the AI calls a list tool to resolve the id before fetching details or acting, it never guesses ids.

• Confirm before write. For reviewAffiliate, the AI first lists the matching pending records, shows you the count (and any unverified-email warnings), and only acts after you confirm.

• Count vs list. When you only want a number, the AI uses a Count tool instead of pulling the full list.

Data privacy - How PII is protected

To prevent AI models from reading or collecting personal information, the read tools mask or hide PII before returning data:

• Affiliate info

  • Hidden: address, postal code, tax documents (W-9, VAT/tax number), payment account/card numbers

  • Masked: phone number — first 3 digits hidden (e.g. ***9876543)

• Referral info

  • Masked: customer email — first 3 letters before the @ hidden (e.g. [e-mail] → ***[e-mail])

• Analytics and program info

  • No personal data, nothing hidden.

Tool limits

Action	Limit
List / read (affiliates, referrals, programs)	Up to 100 records per page. For more, the AI pages through results automatically.
Count (total affiliates / referrals / programs)	No limit — returns a single total.
Review affiliates (approve / deny)	Up to 100 affiliates per request, and up to 200 affiliates per 15 minutes.
All tools	Up to 100 requests per minute per store 15 concurrent requests across the system Each tool may take up to 60 seconds to respond 5 simultaneous connections per IP address