# Effiliation MCP

> Effiliation manages your entire affiliate ecosystem directly through natural language commands. Your agent can check program status, track every conversion, and pull detailed payment reports without needing manual API calls or dashboard navigation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** affiliate-marketing, conversion-tracking, performance-analytics, commission-management, marketing-campaigns, real-time-reporting

## Description

You've got affiliates making sales across dozens of campaigns, and the data gets messy fast. This MCP lets your AI client handle that chaos. You tell it to 'show me all payouts for last month,' and it handles listing every transaction and calculating the total commission owed. It’s about getting answers—not just raw datasets. Need to check if a specific program is running? Done. Want an instant performance snapshot of click volume versus revenue? No problem.

When you connect this MCP through Vinkius, your agent gets full oversight: from checking basic account metadata to running complex audits on payment history and identifying active campaigns. It turns what used to take hours of clicking tabs into a simple conversation with your AI client.

## Tools

### get_effiliation_metadata
Retrieves account limits and essential metadata for your Effiliation platform.

### get_program_details
Retrieves specific commission structures and detailed information for a named affiliate program.

### quick_affiliate_revenue_audit
Provides a fast summary of recent commission earnings and overall success rates for quick checks.

### get_performance_statistics
Pulls high-level metrics like total clicks, conversions, and estimated revenue for the affiliate account.

### list_active_campaigns
Identifies and lists specific affiliate programs currently marked as 'Active' or 'Running'.

### list_account_payments
Generates a comprehensive list of all payments that have been issued to or recorded against the account.

### list_affiliate_programs
Lists every single affiliate program available within your Effiliation account for review.

### list_latest_conversions
Shows the most recent affiliate conversions that have been tracked in the system.

### list_affiliate_transactions
Retrieves a detailed list of all tracked conversions and associated transaction data.

### search_affiliate_programs
Finds specific affiliate programs using just a keyword or name fragment.

## Prompt Examples

**Prompt:** 
```
List all active affiliate programs.
```

**Response:** 
```
I've found several active programs, including 'Summer Travel Promo' and 'Tech Accessories Deal'. Both are currently 'Running'. Would you like to see the commission rates for the Summer Travel program?
```

**Prompt:** 
```
Show me the latest conversions tracked in Effiliation.
```

**Response:** 
```
I've retrieved 5 recent conversions, including a $150.00 order from 'Summer Promo' (Commission: $15.00) and a $50.00 order from 'Accessories Deal'. All are currently 'Pending Validation'. Should I list the transaction dates?
```

**Prompt:** 
```
Get a summary of my account performance this month.
```

**Response:** 
```
This month, your account has recorded 1,250 clicks, 45 conversions, and a total estimated commission of $1,200.00. The conversion rate is currently 3.6%. Would you like to see which program is performing best?
```

## Capabilities

### Audit program structure
Retrieve all available affiliate programs, view their unique commission rules, and check account limits.

### Track sales performance
Pull real-time statistics on clicks, conversions, and overall revenue trends for your marketing efforts.

### List all transactions
Retrieve a complete list of every tracked conversion and order amount across the platform.

### Review payments owed
Generate reports listing all payments issued to or due from your account.

### Identify running campaigns
Find out which affiliate programs are currently active and generating revenue.

## Use Cases

### Reconciling monthly payouts
The ops specialist needs to verify if the payment recorded in the internal ledger matches the actual payout history. They prompt their agent: 'List all payments issued last month.' The agent uses `list_account_payments` and returns a structured list, allowing immediate reconciliation.

### Investigating sudden revenue drops
A marketer notices a dip in conversions. They ask their agent to check the most recent activity: 'Show me the latest conversions.' The agent runs `list_latest_conversions`, revealing which specific programs were impacted and when.

### Onboarding a new partner
The affiliate manager needs to know if a potential program exists. They tell their agent: 'Search for the 'Summer Sale' campaign.' The agent uses `search_affiliate_programs` and instantly provides status and basic details.

### Checking overall account health
A lead asks for a quarterly update. The agent runs `get_performance_statistics`, pulling together total clicks, conversion rates, and estimated revenue into one easy-to-read summary.

## Benefits

- Stop jumping between sheets to reconcile payouts. Use `list_account_payments` to get a single source of truth for every dollar owed or paid out.
- Never forget the rules on commission splits. With `get_program_details`, your agent checks and reports the exact payout structure for any affiliate program, instantly.
- Need a quick health check? Run `quick_affiliate_revenue_audit` to get an instant summary of success rates and commissions without writing complex SQL queries.
- Monitoring campaigns is simple. Use `list_active_campaigns` or `search_affiliate_programs` to find exactly which programs are running, so you know where to focus your efforts.
- Get a full picture of performance. Running `get_performance_statistics` gives you high-level metrics on clicks and conversions that define overall account health.

## How It Works

The bottom line is, your AI client uses this MCP to act as a single pane of glass over complex affiliate marketing data.

1. First, connect the Effiliation MCP to your AI client using your API key.
2. Next, prompt your agent with a specific request, like 'What were my payouts in Q2?' or 'List all active campaigns.'
3. The system executes the required tool calls and returns structured data that your agent summarizes for you.

## Frequently Asked Questions

**How do I check all my available programs using list_affiliate_programs?**
Run `list_affiliate_programs`. This tool returns every single program in your account, allowing you to see the full scope of your affiliate marketing efforts.

**Can I track payments with list_account_payments and get revenue details?**
Yes. `list_account_payments` retrieves all payment records. You can then cross-reference this data with performance statistics to reconcile your total expected revenue against actual payouts.

**What is the difference between list_affiliate_transactions and list_latest_conversions?**
`list_affiliate_transactions` gives you a full historical list of every conversion. `list_latest_conversions` filters that down, showing only the most recent activity for immediate visibility.

**How do I find commission rates for a specific program using get_program_details?**
Use `get_program_details` and provide the name of the affiliate program. The tool returns all detailed information, including the exact commission rate structure.

**How do I check API rate limits or account constraints using get_effiliation_metadata?**
The tool retrieves your account's current metadata and usage thresholds. This lets you build robust workflows that proactively avoid hitting API throttling errors.

**What key metrics can I pull for a quick overview with get_performance_statistics?**
You receive summarized performance data for your entire affiliate account. It gives an immediate, high-level snapshot of total clicks and overall commission earnings without listing every transaction.

**If I only want to check a specific program by name, how does search_affiliate_programs work?**
It filters the full catalog using a name keyword. Instead of processing all programs, you quickly pinpoint and retrieve details for exactly which affiliate program you need.

**How can I identify only the revenue-generating campaigns with list_active_campaigns?**
This tool specifically filters out inactive or paused programs. Your AI agent will focus its efforts only on campaigns that are currently running and generating live commission data.

**How do I get an Effiliation API Key?**
Log in to your Effiliation account, navigate to your profile or API settings section, and you can generate or retrieve your unique API Key from there.

**Can the agent validate transactions?**
This integration currently focuses on listing and auditing programs and transactions. Validating or declining conversions should be managed via the Effiliation dashboard or specific management API endpoints.

**Does the integration show real-time clicks?**
Yes, you can use the get_performance_statistics tool to retrieve the latest click and interaction volumes as reported by the Effiliation platform.