# FirstPromoter MCP > FirstPromoter manages your entire affiliate ecosystem—from tracking initial sign-ups to processing payouts. This MCP lets you automate promoter management, monitor conversions in real time, and issue manual rewards without leaving your AI chat window. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** affiliate-marketing, referral-program, influencer-marketing, saas-growth, conversion-tracking, rewards-management ## Description Running a referral program shouldn't mean jumping between five different dashboards just to see who’s paying the bills. Connect FirstPromoter via Vinkius to let your agent handle the heavy lifting. You can manage all of your affiliates, check performance metrics, and even create new promoter profiles using simple conversation prompts. Need to know which leads are converting? Your agent monitors incoming leads and shows you exactly who is driving value. Want to pay out commissions? List rewards or manually add a commission for any specific affiliate. Whether you need campaign insights, detailed reports on revenue, or just the total count of pending payouts, your AI client pulls it all together instantly. ## Tools ### create_promoter Adds a brand new affiliate account to your system. ### create_reward Manually adds a commission reward for an existing promoter. ### get_campaign_report Retrieves the full performance metrics for a specific affiliate campaign. ### get_lead Fetches the detailed information of a single incoming lead. ### get_payout_stats Provides an overview showing total paid and pending commission amounts. ### get_promoter_report Generates a comprehensive performance report for one specific promoter. ### get_promoter Retrieves the basic details of an affiliate by their ID. ### list_campaigns Lists all active and past affiliate campaigns running in your program. ### list_conversions Displays a list of every conversion that has occurred in the system. ### list_leads Shows all incoming leads recorded by your affiliate program. ### list_promoters Retrieves a list of every active and inactive promoter account in the system. ### list_rewards Lists all commission rewards that have been issued or are pending. ## Prompt Examples **Prompt:** ``` List my top 10 promoters by revenue. ``` **Response:** ``` Retrieving top promoters... I found your top 10 affiliates, led by 'John Doe' ($5,400 revenue) and 'Jane Smith' ($4,200 revenue). Would you like the full details for any of them? ``` **Prompt:** ``` Show me the payout stats for this month. ``` **Response:** ``` Fetching payout statistics... Total paid this month: $12,500. Total pending payouts: $3,200. There are currently 15 promoters awaiting payment approval. ``` **Prompt:** ``` Create a new reward of $50.00 for promoter ID 'prom_456'. ``` **Response:** ``` Reward created! I've manually added a commission of $50.00 (5000 cents) to promoter ID 'prom_456'. The reward is now pending in their account. ``` ## Capabilities ### Manage Affiliate Profiles The agent can list existing affiliates and create new promoter profiles for your system. ### Track Lead and Conversion Data You get real-time lists of incoming leads and all tracked conversions, helping pinpoint top performers. ### Calculate Payout Statuses The system provides high-level reports on total paid amounts versus pending payouts across your network. ### Process Rewards and Commissions You can list all rewards and manually create new commissions for specific promoters. ### Generate Performance Reports The agent pulls detailed reports on both individual promoters and entire affiliate campaigns. ## Use Cases ### Identifying the best promoters by revenue. The founder needs to know who drove the most sales last quarter. They ask their agent, 'List my top 10 promoters by revenue.' The agent retrieves this data and shows them the names and total earnings without needing a spreadsheet or database query. ### Handling an immediate commission payout. An affiliate hits a milestone but the payment system is slow. Instead of waiting, the manager simply prompts the agent to 'Create a new reward of $50.00 for promoter ID X.' The agent issues the commission immediately. ### Auditing recent conversions. The marketing team notices an unusual spike in activity and needs immediate verification. They ask the agent to 'list all conversions' or use get_lead to check specific lead details, verifying the source of revenue instantly. ### Checking overall financial health. The finance team needs a quick snapshot before closing books. They prompt the agent for payout statistics; it delivers the total paid and total pending amounts in one response. ## Benefits - Check top affiliate performance instantly. Instead of running a dashboard report just to find out who's doing well, ask the agent to generate a promoter report or list the best earners right away. - Streamline reward processing. You can manually create rewards for specific promoters using the create_reward tool, bypassing tedious internal forms when someone deserves an immediate commission payout. - Maintain visibility into every lead. The agent monitors incoming leads and conversions by listing all leads or all conversions, keeping your marketing and finance teams perfectly aligned on revenue sources. - Review program status fast. Get a high-level view of money movement by requesting payout statistics. You immediately know the total paid versus how much is still pending approval. - Understand campaign health at a glance. Use list_campaigns to see all active programs, and then get_campaign_report for deep insights into which campaigns are actually generating revenue. ## How It Works The bottom line is, you get a single conversational window into your entire affiliate marketing back end. 1. Subscribe to this MCP through the Vinkius Marketplace, then provide your FirstPromoter API Key and Account ID. 2. Your AI client accesses the data using your credentials, allowing you to request specific information or actions via natural conversation. 3. The agent processes the request, pulls the relevant data from FirstPromoter, and presents clear, actionable reports directly in the chat. ## Frequently Asked Questions **Can FirstPromoter MCP list all my promoters?** Yes. The agent can use list_promoters to retrieve a comprehensive roster of every affiliate in your system, whether they are active or dormant. **How do I check if there are pending payments using FirstPromoter MCP?** You ask the agent to get_payout_stats. This immediately provides a high-level overview showing exactly how much money is paid versus what total amount is still waiting for approval. **Does FirstPromoter MCP track leads and conversions?** It does. You can list_leads to see all incoming sign-ups, or use list_conversions to review every successful conversion that has occurred through the program. **What if I need a detailed report for one promoter? Should I use get_promoter_report?** Yes. Use get_promoter_report when you want deep, specific metrics on just one affiliate's performance, isolating their revenue and activity history. **How do I create a reward for an affiliate using FirstPromoter MCP?** You use the create_reward tool. You simply tell your agent to 'create a new reward of [amount] for promoter ID [ID]', and it handles the commission creation.