# Commission Factory MCP > Commission Factory lets your AI agent manage complex affiliate marketing data through natural conversation. Instead of clicking through confusing dashboards, you can ask for things like total commissions or specific transaction details instantly. It’s a direct link to retrieving merchant information, tracking conversions, and listing all active promotions from your partnered affiliates. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** affiliate-marketing, conversion-tracking, performance-marketing, transaction-reporting, merchant-management ## Description Managing an affiliate network means jumping between dozens of reports—checking payouts here, confirming a coupon code there, and cross-referencing transactions somewhere else. This MCP changes that. You connect it to any AI agent, and you treat your entire affiliate program like a conversation with a knowledgeable teammate. You can ask for the total generated sales value for Q3 or list every active promotion from your top merchants. It pulls together merchant details, transaction histories, and performance summaries without you needing to know which report to click first. Since it connects via Vinkius, all this data lives in one place, accessible through simple chat commands. You just talk to your agent, and it handles the complex API calls behind the scenes. ## Tools ### get_merchant_details Retrieves specific information about any single merchant in the network. ### get_performance_summary Calculates your total commission and sale value for a defined set of transactions. ### get_transaction_details Pulls all granular details related to one specific affiliate transaction ID. ### list_affiliate_merchants Provides a list of every merchant available in the entire Commission Factory network. ### list_affiliate_transactions Retrieves a full, paginated list of all transactions tied to your affiliate account. ### list_merchant_affiliates Gets a roster of affiliates who are currently joined to a specific merchant program you manage. ### list_merchant_transactions Retrieves all transactions generated specifically for one of your managed merchant campaigns. ### list_promotions Gathers active coupon codes and ongoing promotions from merchants you've partnered with. ## Prompt Examples **Prompt:** ``` Show me the last 20 affiliate transactions in Commission Factory. ``` **Response:** ``` I've fetched your last 20 transactions. You have 5 approved transactions and 15 pending ones. The total commission value is $240.20. Would you like a breakdown by merchant? ``` **Prompt:** ``` List all active promotions and coupon codes from my joined merchants in Commission Factory. ``` **Response:** ``` Here are the active coupons from your merchants: 1. '10% Off Shoes' at TrendyFootwear (Code: TF10), 2. 'Free Shipping' at GadgetStore (Code: FREESHIP). Do you need the affiliate links for any of these? ``` **Prompt:** ``` Calculate my total commission and sales value for the current month in Commission Factory. ``` **Response:** ``` For the current month, your total generated sales value is $4,250.00, resulting in a total commission of $450.75 across 32 conversions. ``` ## Capabilities ### Summarize overall performance Calculate total commissions and sales value across a specific set of affiliate transactions. ### List all network participants Retrieve lists of both available merchants and affiliates joined to your program. ### Track specific payouts Get detailed information about a single, chosen affiliate transaction or merchant account. ### Find current marketing assets Retrieve all active coupon codes and promotional banners from your partnered merchants. ## Use Cases ### Investigating a payment discrepancy A partner reports that a sale went through but they didn't get paid. Instead of spending 20 minutes cross-referencing dashboards, you ask your agent to run `get_transaction_details` for the specific ID and immediately confirm the payout status and commission amount. ### Launching a new campaign You need marketing assets fast. You prompt the MCP to run `list_promotions`, which pulls all active codes from your top 10 merchants, allowing you to build out landing pages in minutes instead of waiting for manual data compilation. ### Auditing a specific merchant's performance You suspect Merchant X isn't performing. You use `get_merchant_details` and then follow up by running `list_merchant_transactions` to see exactly what sales records exist for that merchant's campaign. ### Quickly auditing your whole network You want a high-level view of the entire affiliate ecosystem. You run `list_affiliate_merchants` first, then use those IDs to calculate overall health with `get_performance_summary`, giving you maximum scope in minimal time. ## Benefits - Instead of running manual reports to see what's going on, you can ask your agent for a `get_performance_summary` and get the total commission value instantly. - Need to know who's active? You can use `list_affiliate_merchants` to pull every available merchant ID without opening a single directory tab. - If a client questions a payment, you don't guess. Use `get_transaction_details` to retrieve the exact record and prove where the sale originated. - Finding fresh content ideas is simple: just ask for active coupons using `list_promotions`. You get a list of codes ready to use right away. - You can monitor your own success by running `list_affiliate_transactions` to see a history of everything that's passed through your account. - The MCP lets you check who's selling for a specific merchant using `list_merchant_affiliates`, giving you instant oversight on program participation. ## How It Works The bottom line is: you get instant access to deep affiliate data without ever having to navigate a complex dashboard or write any code yourself. 1. First, subscribe to the Commission Factory MCP on Vinkius and enter your unique API Key. 2. Second, tell your AI client (Claude, Cursor, etc.) what you need—for example, 'What were my top 5 converting merchants last month?' 3. Third, your agent uses the connector to call the necessary tools, compiling a structured report back into a natural conversation format. ## Frequently Asked Questions **How do I see my total earnings using `get_performance_summary`?** You ask your agent to run the `get_performance_summary`, specifying a date range or transaction set. It returns your calculated commission and sales totals in one response, so you don't have to manually sum anything. **Do I need to use `list_affiliate_transactions` for everything?** No. While `list_affiliate_transactions` gives you a full list, if you only care about the commission totals, running `get_performance_summary` is faster because it aggregates the data directly. **What can I do with `list_promotions`?** You use this tool to pull a live list of all active coupons and promotions. This lets you quickly populate marketing materials or check if an affiliate is running a current campaign. **How does `get_merchant_details` help me troubleshoot?** If you are confused about the rules or status of a specific merchant, you run `get_merchant_details`. It pulls up all the relevant policy and setup information so you know exactly what's going on with that partner. **If I only want to see transactions for a specific time period using `list_merchant_transactions`, how do I filter the data?** You pass start and end date parameters with your request. The tool then restricts the results entirely to that defined window, ignoring all other activity outside the dates provided. **When using `get_transaction_details`, what specific error message should I look for if a transaction ID is invalid?** The system returns an HTTP 404 status code and includes a descriptive JSON payload. This confirms that the specific ID you provided does not exist in your account history. **Does `list_affiliate_merchants` allow me to filter for merchants by category or location?** Yes, you can pass optional filters like a category code. This narrows the list significantly, so you only see relevant partners without having to review every merchant. **What information does `list_merchant_affiliates` provide, and how is it different from listing transactions?** This tool provides a roster of affiliates linked to your merchant account. It shows who is connected to the program, not what those individuals have purchased or earned. **How do I get my Commission Factory API key?** You can generate an API key in your Commission Factory dashboard under Profile and Preferences > Apps and API keys. **Is this for affiliates or merchants?** This MCP server supports tools for both Affiliates and Merchants. Your API key determines the data you can access. **What is the UniqueId in transactions?** The UniqueId (often called SubID or ClickID) is a custom value you passed during the initial click to track specific sources or campaigns.