# Adtraction MCP MCP > Adtraction connects your affiliate marketing account directly to your agent, letting you manage complex performance audits using natural conversation. It lets you list all available programs, track real-time transactions and earnings, audit approved marketing channels, and pull detailed statistics—all without logging into a dashboard. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** affiliate-marketing, performance-marketing, transaction-tracking, product-feeds, partner-management, sales-data ## Description Affiliate marketing involves juggling dozens of data streams: commission rates change, campaigns launch daily, and tracking sales across various partners is a nightmare. This MCP handles your entire affiliate operation through simple chat commands. Instead of clicking through separate dashboards to audit programs or track leads, you just ask your agent for what you need. It retrieves everything from listing available advertisers to pulling detailed logs of recent transactions and calculating performance metrics broken down by date. When you connect Adtraction via Vinkius, your AI client talks directly to the data source, letting you manage your partnerships with a conversation. You get clear answers about commission structures or daily sales totals instantly. ## Tools ### list_programs Provides a complete list of all available affiliate programs managed by Adtraction. ### get_program_details Retrieves the specific metadata, including commission rates, for a single affiliate program. ### list_transactions Fetches a record of recent transactions, including the program source and total commission amount for closed sales. ### get_stats_by_program Calculates and returns performance statistics (clicks, sales) for an entire listed program. ### list_channels Lists all marketing channels—like websites or social media accounts—that are approved within the network. ## Prompt Examples **Prompt:** ``` List all advertiser programs in the 'Fashion' category. ``` **Response:** ``` I've retrieved the advertiser programs for the Fashion category. You have 10 available programs, including 'Luxury Apparel', 'Daily Wear', and 'Street Style Shop'. Would you like to see the commission structure for any of them? ``` **Prompt:** ``` Show me my performance stats for today. ``` **Response:** ``` I've pulled your performance stats for today. So far, you have 500 clicks, 12 sales, and $85.50 in pending commissions. Your conversion rate is currently 2.4%. ``` **Prompt:** ``` Retrieve the latest 5 approved transactions. ``` **Response:** ``` I've retrieved your latest 5 approved transactions. They come from programs like 'Tech Store' and 'Travel Booking', totaling $120 in commissions. Would you like to see the breakdown by date? ``` ## Capabilities ### List all available affiliate programs Retrieves a full catalog of every advertiser program Adtraction manages. ### Get detailed payout info for specific partners Pulls the exact commission structure and metadata for any given program you identify. ### Calculate performance metrics Gathers real-time stats, like total clicks or sales, broken down by a chosen date range or program. ### Review recent transactions and earnings Generates a detailed log of approved sales, showing the source program and commission amount for each transaction. ### Audit marketing channels Lists all websites or social media platforms that are currently approved to promote your links. ### Check product feed metadata Retrieves data about the products available for promotion, helping you write targeted content. ## Use Cases ### Identifying new revenue streams A Growth Specialist needs to know which programs offer the best payouts. Instead of checking ten different sites, they ask their agent to list_programs first, then use get_program_details on promising results to compare commission structures quickly. ### Daily performance check A Marketing Operations Manager needs a quick summary for the morning meeting. They simply ask for 'my performance stats today,' and the agent pulls the data using get_stats_by_program, citing key metrics from list_transactions. ### Auditing marketing assets A team lead suspects a partner's website might be outdated. They ask for an audit of approved channels; the agent uses list_channels to verify if the site is still active and correctly listed. ### Content gap analysis A Content Publisher needs product details for a new blog post about tech gadgets. They use the metadata retrieval capabilities to access current product feeds, ensuring their article links to available items. ## Benefits - Stop hunting through dashboards. You can request performance stats by program (get_stats_by_program) or list transactions (list_transactions) in a single chat command, getting the data you need instantly. - Understand your partners better. Use get_program_details to pull commission structures and metadata for any advertiser program without having to navigate their specific portal. - Stay compliant and organized. Easily audit channel status using list_channels, ensuring every marketing site is approved before running a campaign through it. - Never miss a product detail. Quickly check available product feed access and retrieve metadata so you can write content that matches current promotions exactly. - Centralized oversight. Use list_programs to get an immediate overview of the entire affiliate catalog, making it easy to spot high-potential growth areas. ## How It Works The bottom line is you manage complex financial operations by talking to your agent instead of clicking through multiple web dashboards. 1. Subscribe to this MCP and provide your Adtraction API Token. 2. Connect your preferred client (like Claude or Cursor) through Vinkius. 3. Ask a question in plain English, like 'Show me yesterday's performance for the Fashion category,' and receive the data immediately. ## Frequently Asked Questions **How do I check commission rates for a new partner using get_program_details?** You use get_program_details and provide the unique program ID. The agent will return the full metadata, including the precise commission percentage structure and any associated payout caps. **Can list_transactions show me which programs generated sales last month?** Yes, list_transactions retrieves a record of recent deals. You can ask it to filter by date range or program name to narrow down the results and identify top contributors. **What is the best way to get daily performance stats? Do I use get_stats_by_program?** Yes, get_stats_by_program is what you want. You simply tell it which program and which date range you need, and it returns a clean summary of clicks, sales, and leads for that period. **How do I know if a website is approved to promote my links? Should I use list_channels?** You must call list_channels. This tool provides the definitive roster of all marketing channels—websites, social media—that Adtraction has officially approved for your network. **If I change my Adtraction API token, how do I make sure my agent can still run `list_programs`?** You must provide your new API token to your AI client. Updating the credential allows your agent to refresh its connection and execute tools like list_programs without error. **Can I use `get_stats_by_program` to compare performance across several different programs at once?** Yes, you can pass a list of program IDs to the tool. This lets your agent pull comparative reports and helps you spot trends across multiple areas quickly. **When I run `list_transactions`, how do I filter out failed or incomplete sales records?** The API handles status filtering using parameters you provide. You'll need to specify the desired transaction status, like 'approved', in your prompt for the agent to narrow results accurately. **What happens if I try to call `get_program_details` too many times in a short period?** The platform enforces standard API rate limits to protect the data source. If you hit a limit, your agent will pause and notify you, recommending a cooldown period before retrying. **Where do I find my Adtraction API Token?** Log in to your Adtraction account, navigate to **Account** > **Settings** > **API**. You can generate or retrieve your unique token there. It will be used in the `X-Token` header. **Can I see my earnings by advertiser?** Yes! Use the `get_stats_by_program` tool. Your agent will retrieve aggregated statistics for each advertiser you are partnered with, including commissions and conversion rates. **Does this support transaction status tracking?** Yes, the `list_transactions` tool provides the current status (Pending, Approved, Denied) for every sale or lead tracked in your account.