# Goaffpro MCP MCP > Goaffpro connects your affiliate management backend directly to any AI agent via MCP. Manage entire referral programs, track every order and commission payment, and automate bonus rewards without leaving your chat interface. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** affiliate-marketing, influencer-marketing, referral-tracking, commission-management, sales-analytics ## Description Running an e-commerce site means constantly managing external partners. Goaffpro brings all that data—the sales, the commissions, the payouts—into one place accessible to your agent. Instead of jumping between Shopify, accounting software, and a dedicated affiliate dashboard just to check if someone got paid, you ask your AI client directly. You can list every partner in your program, check their current stats, or even grant custom bonuses on the fly. It’s all about visibility and action. By connecting this MCP through Vinkius, you get real-time access to critical operational data for auditing, reporting, and daily management, right from where you're working. ## Tools ### verify_api_connection Tests the connection credentials to confirm that the agent can access your Goaffpro data. ### register_new_affiliate Adds an entirely new partner account to the program database, setting up their initial profile. ### grant_affiliate_reward Issues a custom bonus reward or signup grant to an existing affiliate partner. ### find_affiliate_by_email Searches the affiliate database using a specific email address to find a partner's record. ### get_program_details Fetches basic identity information about your entire affiliate program setup. ### get_affiliate_details Retrieves comprehensive metadata and current stats for a specified affiliate. ### list_program_affiliates Gets a complete list of every affiliate currently registered in the program. ### list_earned_commissions Provides a detailed log of all commission events that have been earned but may not yet be paid out. ### list_referral_orders Retrieves a comprehensive list of all sales and orders attributed to an affiliated partner. ### list_affiliate_payouts Generates a list detailing all past payments made out to affiliates, including status and dates. ### list_top_performers Generates a report identifying the highest-performing affiliates based on recent activity and earnings. ### list_affiliate_webhooks Shows the configuration settings for webhooks associated with specific affiliates. ## Prompt Examples **Prompt:** ``` List all active affiliates in my program. ``` **Response:** ``` Retrieving affiliates... I found 5 active partners, including 'Jane Smith' (ID: 123) and 'Growth Blog'. Would you like the performance stats for any of them? ``` **Prompt:** ``` Show me the referral orders for affiliate ID '987'. ``` **Response:** ``` Fetching referral orders... Affiliate 987 has driven 3 orders today totaling $450.00. All orders are currently 'Paid'. ``` **Prompt:** ``` Grant a $10 bonus to affiliate 'jane@example.com'. ``` **Response:** ``` Bonus granted! I have successfully issued a $10.00 reward to Jane Smith for 'Exceptional performance'. She will see this in her affiliate dashboard. ``` ## Capabilities ### View Partner Directory List all affiliates in your program or search for a specific partner using their email address. ### Audit Sales and Orders Retrieve detailed lists of orders generated by affiliates to determine who is driving the most revenue. ### Manage Financial Records Access logs for earned commissions or review full histories of payments made to partners. ### Adjust Partner Status and Rewards Add new affiliates to the program or issue custom signup bonuses without logging into a separate portal. ### Identify Top Performers Quickly generate reports showing your highest-earning partners for performance review. ## Use Cases ### The Weekly Audit The Finance Analyst needs to prepare for tax season. They ask their agent to run `list_affiliate_payouts` and then cross-reference the results with `list_earned_commissions`. This gets them a clean, auditable view of all transactions without exporting data multiple times. ### Onboarding a New Partner The Marketing Manager finds a great influencer. They use their agent to run `register_new_affiliate` first. Then, they immediately call `grant_affiliate_reward` to give the partner an initial bonus and get them started. ### Performance Review Prep The Owner needs data for a board meeting. They ask their agent to run `list_top_performers`. The agent compiles this list, making it easy to understand which partners are driving the most revenue that month. ### Investigating an Order A customer calls about a specific purchase. Instead of asking staff to look up orders in three different systems, they ask their agent to run `list_referral_orders` for the associated affiliate ID and instantly get confirmation on the sale details. ## Benefits - Stop digging through spreadsheets. You can list all affiliates or find a specific partner using `find_affiliate_by_email` right in your chat window. - Get an instant view of referral performance by calling `list_top_performers`, immediately identifying who needs recognition or a bonus. - Simplify compliance and accounting. Run the `list_affiliate_payouts` tool to get a complete, filterable history of all payments made out this quarter. - Handle onboarding and motivation in one go. You can use `register_new_affiliate` to sign someone up and then follow up with `grant_affiliate_reward` for their initial bonus. - Track sales activity simply by calling `list_referral_orders`. This gives you a quick, clear picture of the revenue stream from your partners. ## How It Works The bottom line is that your agent acts like an API wrapper; you just talk to it instead of writing code or navigating dashboards. 1. First, subscribe to the Goaffpro MCP through Vinkius and enter your API Access Token in the connection settings. 2. Next, tell your agent what you need. For example, 'Show me all payouts for Q2' or 'What did Jane Smith sell last month?' 3. Your agent sends a request to the MCP, which pulls the live data from Goaffpro and delivers it back as plain text results. ## Frequently Asked Questions **How do I get an API Access Token for Goaffpro?** Log in to your Goaffpro Admin Panel, navigate to Settings > Advanced, and you can create or copy your API Access Token in the Access Tokens section. **Can I approve pending commissions via the agent?** The current version supports listing and retrieving commission details. Status update tools may be added in future updates to maintain safe financial workflows. **How do I find an Affiliate ID?** Use the 'list_program_affiliates' tool. The agent will return all affiliates in your program along with their unique IDs and names. **Is it possible to grant bonuses through the chat?** Yes! Use the 'grant_affiliate_reward' tool and provide the Affiliate ID, amount, and reason to instantly issue a bonus to your partner. **What does the `verify_api_connection` command check for?** It confirms that your AI client has valid credentials and access rights. Running this tool verifies the entire connection path, ensuring you can start running other commands like `list_referral_orders` immediately. **How do I use `list_earned_commissions` to view data from a specific time period?** The tool accepts date range parameters and status filters. You can specify the start and end dates, or narrow down results to 'pending' commissions for targeted auditing. **What information is required when running the `register_new_affiliate` tool?** You need basic details like a name, email address, and desired program enrollment. This allows your agent to onboard new partners without manual dashboard input. **If I need an overview, what does `get_program_details` provide about my affiliate setup?** This tool pulls the foundational identity of your entire affiliate program. It gives you necessary parameters and general rules that govern all subsequent actions, like listing affiliates or viewing payouts.