# Offerslook MCP > Offerslook MCP Server connects your AI agent directly to your performance marketing network. You can manage everything—offers, affiliates, advertisers, and campaign performance—without ever logging into the dashboard. Need a payout report for Q3? Just ask. Want to check if an advertiser is still active? Done. This tool lets you handle complex partner management operations using only natural conversation. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** affiliate-marketing, performance-tracking, ad-campaigns, payout-management, partner-management, conversion-tracking ## Description You connect your AI agent straight into your Offerslook network, letting you run complex partner management operations without ever touching a dashboard tab. This server turns manual clicks into natural conversation with your agent; it speaks directly to the core data for instant access to offers, partners, and revenue reports. To get a full picture of your marketing assets, you can first pull a comprehensive list of every single marketing offer—whether it's currently active or if it’s been paused. You also retrieve the organizational categories that group these offers. When you need deep metadata on one specific asset, you fetch complete data for an offer ID using `get_offer_details`, which shows you everything from payout rules to tracking configurations. When dealing with partners, your agent handles it all. You pull a full roster of every affiliate and publisher associated with the network via `list_affiliates`. Similarly, you can get detailed performance and status information for any single affiliate partner using `get_affiliate_details`. If you need to check on advertisers, you first get a list of everyone currently registered in your account through `list_advertisers`; then, if you have their ID, you pull specific profile details for that advertiser with `get_advertiser_details`. For tracking activity and performance numbers, the server gives you visibility into what's running right now. You can view a list of all current marketing campaigns using `list_active_campaigns`, or get a real-time feed of the most recently recorded conversion events across every campaign via `list_recent_conversions`. If you need historical data, your agent generates an aggregated performance report for any time period, showing clicks, conversions, and total revenue. You can also run reports covering specific date ranges using `get_performance_report`. Every piece of partner information—the offer metadata, the advertiser profiles, or the affiliate status checks—is available through unique IDs. This setup lets you manage everything from campaign oversight to payout rule verification using only what you say. You don't need to log in; your agent just asks for it. ## Tools ### get_advertiser_details Retrieves the specific profile details for a single advertiser ID in your network. ### get_affiliate_details Gets the detailed performance and status information for one affiliate partner. ### get_offer_details Fetches all metadata, payout rules, and tracking configuration for a specific marketing offer ID. ### get_performance_report Generates an aggregated report showing clicks, conversions, and revenue metrics over a selected date range. ### list_advertisers Provides a list of all advertisers currently registered in your Offerslook account. ### list_affiliates Returns a full roster of all affiliates and publishers associated with the network. ### list_active_campaigns Lists all current and running marketing campaigns in the network for review. ### list_offer_categories Lists the organizational categories used to group and manage marketing offers. ### list_recent_conversions Shows a running feed of the most recently recorded conversion events across all campaigns. ### list_offers Retrieves a comprehensive list of every marketing offer, both active and paused. ## Prompt Examples **Prompt:** ``` List all active offers in my network. ``` **Response:** ``` Retrieving offers... I found 15 active offers including 'E-commerce Summer Sale', 'VPN Pro Trial', and 'Flash Deal'. Would you like the payout details for the Summer Sale? ``` **Prompt:** ``` What is the status of advertiser ID 'adv_98765'? ``` **Response:** ``` Inspecting advertiser adv_98765... The profile belongs to 'Global Brands Inc.'. It is currently 'Active' and has 3 running campaigns. Shall I list their recent conversion metrics? ``` **Prompt:** ``` Show me the performance report for the first week of March. ``` **Response:** ``` Generating performance report... For the week of March 1st to March 7th, your network generated 45,000 clicks and 1,250 conversions, resulting in $8,400 in revenue. Would you like to see which affiliate performed best during this period? ``` ## Capabilities ### List all offers and categories Pull a list of every active, paused, or categorized marketing offer in the network. ### Check partner status (Advertisers/Affiliates) Get specific profile details for any advertiser or affiliate using their unique IDs. ### Track campaign activity View a list of all running marketing campaigns and monitor recent conversion events in real-time. ### Generate performance reports by date range Create aggregated reports showing clicks, conversions, and total revenue for any specified time period. ### Retrieve deep metadata on specific assets Fetch complete data—including payout rules or partner metrics—for a single offer, advertiser, or affiliate ID. ## Use Cases ### Auditing a Conversion Discrepancy A marketer spots that revenue numbers look off. They ask their agent to run `get_performance_report` for the last 7 days. The report shows $10k, but they suspect a specific campaign is wrong. They then use `list_active_campaigns`, identify the suspicious campaign ID, and finally call `get_offer_details` using the campaign's linked offer ID to check payout rules. Problem solved: it was an outdated tracking setting. ### Onboarding a New Partner An affiliate manager needs to verify if a new publisher is ready for payouts. They use `list_affiliates` to check the roster, find the partner's ID, and run `get_affiliate_details`. The agent immediately reports that the account is 'Pending Review,' letting the manager know exactly what steps are needed. ### Quick Offer Status Check A team member needs to confirm if a specific marketing offer, 'Summer Sale 2024', is currently active and paying out correctly. Instead of navigating deep menus, they ask their agent to run `get_offer_details` with the offer ID, which instantly returns the status, payout structure, and last update date. ### Monthly Performance Review The analyst needs a clean data set for a board presentation. They ask the agent to run `get_performance_report` covering the previous month's dates. The agent returns the total clicks, conversions, and revenue, providing an immediate, quantified summary ready for copy-pasting into slides. ## Benefits - Instantly diagnose payout issues. Use `get_offer_details` to pull the exact tracking and payout configuration for any offer ID, saving you time wading through documentation. - Never lose track of a partner. You can check status updates or view performance metrics for advertisers or affiliates using dedicated tools like `get_advertiser_details` and `list_affiliates`. - Automate reporting runs. Instead of manually pulling data, just ask your agent to run `get_performance_report` for 'last quarter' and get the full breakdown in seconds. - See real-time activity. The `list_recent_conversions` tool gives you a live feed of conversions, letting you spot performance dips or spikes immediately as they happen. - Understand your whole catalog. Need to know which category an offer belongs to? Use `list_offer_categories` first, then dive into the specifics with `list_offers`. ## How It Works The bottom line is that you manage your entire marketing network from conversational prompts instead of clicking through multiple web dashboards. 1. First, subscribe to the Offerslook server and pass your Network ID and API Key. 2. Next, tell your AI client what you need. For example: 'Show me the performance report for last month.' 3. The agent runs `get_performance_report`, fetches the structured data, and gives you a clear summary in plain language. ## Frequently Asked Questions **How do I use get_advertiser_details? ** You provide a specific advertiser ID (e.g., 'adv_98765'). The agent runs `get_advertiser_details` and gives you the profile info, including their current status and running campaigns. **Can I list all offers using list_offers? ** Yep. Running `list_offers` provides a master list of every marketing offer in your network, letting you see what's active or paused right away. **What is the difference between listing advertisers and affiliates? ** They track different types of partners. Use `list_advertisers` for brand accounts paying for traffic, and use `list_affiliates` for publishers earning commissions on sales. **How do I get a performance report for a specific date range? ** You call the `get_performance_report` tool and must specify the start and end dates in your prompt. The agent then calculates clicks, conversions, and revenue for that window. **When running any tool, like list_advertisers, how do I handle API authentication errors?** You need to verify that your Offerslook Network ID and API Key are correctly set up in the server connection. If you receive an error code like 401, double-check those credentials first; they're the most common failure point. **If I use get_offer_details, can I filter the search by a specific category?** Yes. First, run list_offer_categories to pull all available group IDs. Then, pass that specific Category ID into your call to get_offer_details for targeted results. **Does list_recent_conversions have a limit on how many data entries it can retrieve in one go?** It typically pulls the last 100 conversion records per request. If you need to analyze older or larger datasets, run the tool repeatedly or implement an iterative query method. **What specific status information does list_active_campaigns provide?** The output lists key details for every campaign, including its current operational status (Active, Paused, Ended) and performance metrics. This lets you quickly audit which campaigns are running live. **Where do I find my Offerslook API Key?** Log in to your Offerslook network dashboard and navigate to the API settings section to find your Network ID and API Key. **Can I see conversions in real-time?** Yes! Use the `list_recent_conversions` tool to retrieve a list of the latest successful goal completions in your network. **How do I generate a performance report?** The `get_performance_report` tool allows you to specify a start and end date to retrieve aggregated metrics for your network.