# FirstPromoter MCP for AI Agents AI Agent Connect

> FirstPromoter lets you manage your entire affiliate and referral marketing ecosystem through your AI client. You can handle promoter profiles, track conversion data, and process rewards without jumping between tabs. It turns your AI into a marketing operations assistant that keeps your referral programs running on autopilot.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_VxmnCjusaHw9LODXySW9ldw8lDgfMNtqhm2lEctb/ai-agent-connect
- **Tags:** affiliate-marketing, referral-program, influencer-marketing, saas-growth, conversion-tracking, rewards-management

## Description

This Connector lets you manage your entire affiliate and referral marketing ecosystem through your AI client. You can handle promoter profiles, track conversion data, and process rewards without jumping between tabs. It turns your AI into a marketing operations assistant that keeps your referral programs running on autopilot. Because Vinkius hosts this connection, you get a reliable way to bridge your account with your favorite AI tools. Instead of manual data entry, you just tell your agent what needs to happen, and it executes the commands to update rewards or fetch reports. It's about moving from 'how do I find this?' to 'tell me what happened today.'

Instead of logging into a separate dashboard to see who your best partners are, you can just ask your agent for a summary of your top performers. You can see which campaigns are actually moving the needle and which ones are just burning your budget. When an influencer reaches a milestone and deserves a bonus, you don't have to hunt for their ID and manually calculate a payout. You can just tell your agent to issue a reward, and it handles the rest. This is about getting your hands out of the weeds of data entry and back into the strategy of growing your brand. It makes the heavy lifting of referral management feel like a simple conversation.

## Tools

### list_promoters
The list_promoters tool pulls a list of all the promoters in your program. Use it to see your entire affiliate base.

### create_promoter
The create_promoter tool creates a new promoter profile. Use it to quickly add new affiliates to your program.

### create_reward
The create_reward tool adds a new reward or commission. It is useful for issuing manual payments to specific partners.

### get_campaign_report
The get_campaign_report tool pulls performance data for a specific campaign. Use it to see which marketing efforts are converting best.

### get_lead
The get_lead tool retrieves specific details for an incoming lead. This helps you track where your new traffic is coming from.

### get_payout_stats
The get_payout_stats tool gives you a high-level overview of your payouts. Use it to see total paid and pending amounts at a glance.

### get_promoter_report
The get_promoter_report tool pulls a detailed performance report for an individual promoter. It shows their specific revenue and conversion data.

### get_promoter
The get_promoter tool fetches the specific details of a promoter profile. Use it to check the status of a particular affiliate.

### list_campaigns
The list_campaigns tool pulls a list of all your active affiliate campaigns. Use it to manage your different marketing tracks.

### list_conversions
The list_conversions tool shows a list of all successful conversions. Use it to monitor the growth of your referral program.

### list_leads
The list_leads tool shows a list of all leads in your system. This is great for monitoring real-time traffic.

### list_rewards
The list_rewards tool shows a list of all rewards and commissions. It helps you keep track of what has been issued.

## Prompt Examples

**Prompt:** 
```
Who are my top 5 promoters this month?
```

**Response:** 
```
### Top 5 Promoters (Current Month)

| Promoter Name | Revenue | Conversions |
| :--- | :--- | :--- |
| John Doe | $5,400 | 120 |
| Jane Smith | $4,200 | 98 |
| TechReviewer | $3,100 | 75 |
| Influencer_X | $2,800 | 60 |
| Sarah_M | $2,100 | 45 |

Would you like to see the full report for any of these partners?
```

**Prompt:** 
```
Show me the payout status.
```

**Response:** 
```
### Payout Statistics

*   **Total Paid:** $12,500
*   **Total Pending:** $3,200
*   **Pending Approvals:** 15 promoters

All payouts are currently up to date for the previous cycle.
```

**Prompt:** 
```
Create a $100 reward for promoter 'influencer_99'.
```

**Response:** 
```
✅ **Reward Created!**

I've added a manual commission of **$100.00** to promoter **influencer_99**. The reward is now pending in their account for approval.
```

## Capabilities

### Track real-time leads
See exactly where your traffic is coming from as it happens.

### Issue manual rewards
Create specific commissions for influencers on the fly.

### Analyze campaign performance
Get a breakdown of which marketing efforts are actually converting.

### Monitor payout statuses
Keep an eye on what's paid and what's still pending.

### Manage promoter profiles
Create and update affiliate accounts with just a few words.

### Review conversion data
See the full history of successful referrals in one view.

## Use Cases

### The manual reward headache
An influencer asks for a custom deal. Instead of logging in and digging, you tell your agent to use create_reward for them.

### The 'who's winning?' query
You want to know which campaign is best. Your agent uses list_campaigns and get_campaign_report to give you the winner.

### The end-of-month audit
You need to check payouts. Your agent pulls get_payout_stats and list_conversions to summarize the month's revenue.

### New promoter onboarding
A new partner signs up. You tell your agent to use create_promoter to get them into the system immediately.

## Benefits

- Stop manual data entry by using create_promoter to onboard new influencers in seconds.
- Get instant visibility into your finances by using get_payout_stats to see pending amounts.
- Optimize your marketing spend by using get_campaign_report to see which channels actually convert.
- Handle custom influencer deals quickly with create_reward to issue manual commissions.
- Keep your team aligned by using list_leads and list_conversions to see real-time growth.
- Save hours of reporting time by using get_promoter_report to pull stats for specific partners.

## How It Works

The bottom line is you get a direct line from your AI to your entire affiliate marketing backend.

1. Subscribe to the FirstPromoter MCP on the Vinkius Marketplace.
2. Paste your API Key and Account ID from your FirstPromoter settings into your AI client.
3. Ask your agent to list your top promoters or pull a campaign report.

## Frequently Asked Questions

**Can I use FirstPromoter MCP to manage my influencers?**
Yes, it lets you create promoter profiles and manage their rewards directly through your AI client. You can handle everything from onboarding to issuing custom commissions.

**How does FirstPromoter MCP help with affiliate marketing?**
It automates the data retrieval for campaigns, leads, and conversions. This means you don't have to manually check the dashboard to see how your program is performing.

**Can I see my payouts with FirstPromoter MCP?**
You can get a high-level overview of your total paid and pending payout statistics instantly. It helps you keep a clear eye on your marketing spend.

**Does FirstPromoter MCP support creating manual rewards?**
Yes, you can tell your agent to create specific rewards or commissions for your partners on the fly. This is perfect for handling unique influencer deals.

**Is FirstPromoter MCP good for SaaS companies?**
It's designed specifically for SaaS companies to manage their referral and influencer programs more efficiently. It helps you scale your growth engine without increasing your manual workload.

**How can I search for a specific promoter using the agent?**
You can use the 'list_promoters' tool and provide a search term in the 'q' parameter. This can be the promoter's name, email, or referral ID. The agent will return matching profiles.

**Can I manually award a commission to an affiliate?**
Yes! The 'create_reward' tool allows you to manually create a reward for a specific promoter by providing their ID and the amount in cents.

**Is it possible to see which campaigns are performing best?**
Absolutely. Use the 'get_campaign_report' tool to retrieve aggregate performance metrics across all your active campaigns, including referral counts and revenue generated.