In this article, we will cover:
Firstly, what is MCP?
MCP stands for Model Context Protocol. Don't let the technical name put you off - the idea behind it is simple.
Normally, an AI assistant like Claude, ChatGPT, Gemini, Antigravity etc. only knows what you tell it in the conversation. It can't log into your Tapfiliate account, check your affiliate list, paid commissions or generated revenue on its own: it's cut off from your actual business tools.
MCP removes that wall. It's a standard "connector" that lets Claude securely plug into the tools you already use like Tapfiliate so it can look up real information and take real actions on your behalf, instead of just talking about them.
A simple way to think about it: MCP is like a USB port for AI. Just as a USB port lets you plug all kinds of different devices into your laptop using one standard connection, MCP lets your AI Assistant (eg. Claude, Gemini etc.) plug into all kinds of different business tools - Tapfiliate, email, calendars, spreadsheets - using one standard connection. You don't need custom software or technical setup for each one; the connection just works.
So what is the Tapfiliate MCP integration?
It's that same connector, built specifically for Tapfiliate. Once it's set up, your AI Assistant is no longer just a chatbot that talks about your affiliate program - it becomes an assistant that can actually reach into your Tapfiliate account, pull live data and carry out tasks for you, all through plain, everyday language. No dashboard clicking, no manual exports, no spreadsheets.
With Tapfiliate MCP connected, you can simply ask things like:
"List all active affiliates for this month"
"Retrieve clicks data for affiliate Jane Doe"
"Find inactive affiliates for program X and give me recommendations about the program's optimisation'
"List all commissions for the Summer Promo program"
Your AI Assistant handles the request, pulls the live data from Tapfiliate and gives you a clear, ready-to-use answer.
What Are the Benefits?
Faster, natural-language access to your affiliate data. No need to log in, navigate menus or build custom reports. Ask a question or give an instruction, and get an answer immediately.
Less manual admin work. Routine tasks - checking affiliate status, pulling payout details, reviewing commissions can be handled conversationally instead of through repetitive manual steps.
Real-time accuracy. Because the integration pulls live data directly from your Tapfiliate account, you're always working with current numbers, not a stale export or yesterday's spreadsheet.
Lower barrier for non-technical team members. Marketers and program managers don't need to know the Tapfiliate dashboard inside-out or write API calls. If you can describe what you need, you can get it.
Secure, permissioned access. Authentication is handled when the integration is set up, and access can be scoped to only the data and actions you approve - your affiliate data isn't exposed beyond what's needed.
Scales with your workflow. Whether it's a one-off lookup or a recurring reporting task (e.g., a weekly summary of new affiliate sign-ups or commissions), the same natural-language interface handles both.
What Do You Need to Get Started?
To use the Tapfiliate MCP integration, make sure you have the following in place:
An active Tapfiliate account with Admin-level permissions. Admin access ensures the integration can reach the full scope of data and actions it supports.
API/Zapier access enabled on your Tapfiliate account. Together with Admin permissions, this unlocks all the data currently available through the integration.
An AI assistant that supports MCP, such as Claude or Cursor, or Antigravity connected to your Tapfiliate account.
Activity tracked in your account (clicks, conversions, affiliates etc.). Your assistant works with whatever data your account actually has - it doesn't invent numbers or make projections out of thin air. The more activity you've tracked, the richer and more accurate the reports, trends and conclusions it can give you.
How to Connect?
The Tapfiliate MCP server works with any AI assistant that supports the Model Context Protocol. Setup steps for the most popular AI assistants as Claude and Cursor are outlined below.
A few things worth knowing before you start:
Each assistant is connected separately. Connecting Tapfiliate in Cursor has no effect on Claude, and connecting it in Claude has no effect on Cursor. If you plan to use both, you'll need to complete the setup steps for each one individually.
In Claude, there are two ways to connect - through the configuration file or through the Connectors UI. You only need to use one of these methods, not both.
Adding the Tapfiliate MCP server
Setup steps for the most popular AI assistants: Claude, Cursor and Google Antigravity are outlined below.
For Cursor:
Go to Settings > Tools & MCPs.
Click + Add New MCP Server.
Set Name to
tapfiliate.Paste in the following configuration:
json
{
"mcpServers": {
"tapfiliate-prod": {
"url": "https://mcp.tapfiliate.com/mcp"
}
}
}
5. Save, and you're set. Cursor will now list Tapfiliate as an available tool.
6. The system will redirect you to the browser screen to authorize access to your Tapfiliate data > Click Allow.
7. Now you're back in the Cursor interface, you'll see the Tapfiliate MCP connected to your account.
For Claude Desktop:
You can connect using either of the two methods below, you only need to do one of them.
Method 1, edit the config file directly:
Open your config file:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Paste the JSON block below inside the file.
json
{
"mcpServers": {
"tapfiliate-prod": {
"url": "https://mcp.tapfiliate.com/mcp"
}
}
}
3. Save the file and restart Claude Desktop. Tapfiliate should now show as connected under Settings > Connectors.
Method 2, use the Connectors UI:
Open Claude Desktop. Click your profile icon in the bottom-left corner and select Settings.
Click Connectors in the sidebar menu.
Scroll to the bottom of the list and click Add custom connector.
4. Fill out the form:
Name:
tapfiliateURL:
https://mcp.tapfiliate.com/mcp
5. Click Add. Find your new connector in the list and click Connect next to it to activate it.
6. The system will redirect you to the browser screen to authorize access to your Tapfiliate data > Click Allow.
7. Now you're back in the Claude interface, you'll see the Tapfiliate MCP connected to your account.
💡 If Add custom connector isn't available, your admin has likely restricted it. Use Method 1 (config file) instead. It works either way, but only in the Desktop app.
For claude.ai (in your browser):
The config file isn't an option here since there's no local app to edit, so you'll use the Connectors UI:
Go to claude.ai and log in. Click your profile icon in the bottom-left corner and select Settings.
Click Connectors in the sidebar menu.
Scroll to the bottom of the list and click Add custom connector.
Fill out the form:
Name:
tapfiliateURL:
https://mcp.tapfiliate.com/mcp
Click Add. Find your new connector in the list and click Connect next to it to activate it.
The system will redirect you to the browser screen to authorize access to your Tapfiliate data > Click Allow.
Now you're back in the Claude interface, you'll see the Tapfiliate MCP connected to your account.
For Google Antigravity:
Access Google Antigravity and log in.
Locate the Settings section at the page bottom.
Go to Customizations > Click Add MCP
Paste the below script into the config.json file:
{
"mcpServers": {
"tapfiliate-prod": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.tapfiliate.com/mcp"
]
}
}
}
5. Hit Save.
6. The system will redirect you to the browser screen to authorize access to your Tapfiliate data > Click Allow.
7. Now you're back in the Antigravity interface, you'll see the Tapfiliate MCP connected to your account.
💡 If you don't see the server connected, hit the Refresh button in the Customizations > Installed MCP Servers.
Authorize access:
The first time you use a Tapfiliate tool, you'll be prompted to sign in and grant access. This opens a standard OAuth consent screen, the same kind of login you'd see connecting any other app to your account. If your login is linked to more than one Tapfiliate account, you'll be asked to pick the right one (and log in to that specific account) before you get to the consent screen.
Once you allow the connection, the window will prompt you to redirect back to your AI tool. You can open the tool and start asking your queries.
How It Works
Here's the simplest way to think about it: the assistant works with your real Tapfiliate data: clicks, conversions, customers, GMV, commissions, payouts, conversion rates, your commission plan setup and the other affiliate details already in your account. It doesn't guess, and it doesn't make anything up. When it gives you an explanation alongside a number, that's context to help the answer make sense - not a change to your actual data.
When you ask a question, the assistant works out what you're really asking, applies the right logic behind the scenes, pulls your data for the time period that matters, and hands you back a clear answer with a short explanation of what's going on. You can trust it the same way you'd trust a report you pulled yourself.
One thing to flag for now: in this beta release, the assistant is built for analytics - answering questions, surfacing trends, and helping you understand your program. It's not yet set up to take actions like creating payments or making changes on your behalf. That's something we're planning for a future release.
What it can help you with?
Rather than a fixed list of questions, think of this as a set of everyday scenarios the assistant knows how to handle. You don't need to phrase anything in a specific way, ask it however feels natural, and it'll work out what you're after. Here's what it covers today:
Spotting affiliates who bring clicks but no sales. Every affiliate program has a few partners driving traffic that just isn't converting. This flags them for you, so you can catch a broken landing page, a mismatched offer, or a low-quality traffic source before it wastes more of your budget. Try asking: "Who's sending traffic but not sales?", "Any affiliates with clicks but zero conversions?" , "Who's underperforming right now?"
By default, it looks at the last 30 days and flags anyone with 100+ clicks and no conversions. But you can choose any timeframe that is needed for your today's task, just specify it in your request.
Finding your best affiliates. Your top performers deserve the spotlight - whether that's a bigger commission, early access to a new promo, or just a thank-you email. This ranks affiliates by real revenue and conversions they've driven, not commission paid out, since a high commission rate doesn't always mean strong performance. Try asking: "Who are my top affiliates?" , "Show me my best performers this month" , "Who should I be rewarding?".
Catching affiliates who've gone quiet. Affiliates rarely announce when they're losing interest - they just stop converting. This surfaces the ones who used to be active but have cooled off, so you can re-engage them before they're gone for good. Try asking: "Which affiliates have gone quiet?" , "Show me affiliates I've lost touch with" , "Who's stopped converting recently?" Default window is 30 days with no conversions - a standard benchmark in affiliate marketing.
Spotting conversion rates that look off. A conversion rate way above or below your program average is worth a second look - it could mean an affiliate found a great audience fit, or it could be a red flag for low-quality or fraudulent traffic. Try asking: "Any affiliates with unusual conversion rates?" , "Who's converting way better or worse than average?" , "Show me conversion rate outliers".
Checking if your commission structure is actually working. Are you paying the right affiliates the right amount? This compares your commission plans to see which ones attract your best-performing partners, and whether your payouts are actually earning you a return. Try asking: "Is my commission plan working?" , "Which commission tier drives the most revenue?" , "Should I change my commission structure?".
Getting a quick pulse check on your program. Don't have a specific question? Start here. One overview covering your key numbers, top affiliates, anything that needs attention, and a suggested next step. Try asking: "How's my program doing?" ,"Give me a summary" , "What should I focus on this week?".
Following up with new affiliates who haven't started. Recruiting an affiliate is only half the job, getting them active is the other half. This surfaces recently joined affiliates who haven't sent any traffic or conversions yet, while they're still warm and worth a nudge. Try asking: "Which new affiliates haven't started yet?" , "Show me affiliates who joined but aren't active" , "Who needs onboarding help?".
Understanding your program's overall trend. Are you growing, flat, or slipping? This shows the trajectory of your program over any period you choose, and calls out anything worth noticing along the way. Try asking: "Is my program growing?" ,"Show me the trend over the last 6 months" , "Am I trending up or down?".
Reviewing anything that looks suspicious Some traffic patterns just look off - unusually high or low conversion rates, spikes that don't match normal behavior. This gives you a starting point to investigate further; it's a flag for your review, not a verdict. Try asking: "Any fraud signals in my program?" , "Does any affiliate traffic look suspicious?" , "Should I be worried about any affiliates?".
Getting the full story on one affiliate. Give it a name and get the complete picture in one go: when they joined, their plan, clicks, conversions, conversion rate, revenue, and how they're trending compared to last period. Try asking: "Tell me about [affiliate name]" , "How is [affiliate] performing?" , "Give me [affiliate]'s full stats".
Our recommendation: don't overthink your wording. The scenarios above are starting points, not a script, try asking things your own way, follow up with "why" or "what about last quarter," and see where the conversation takes you. The more you experiment, the more you'll get a feel for what it can do.
FAQs
❓Do I need to be technical to use this?
Not at all. If you can type a question in plain language, you're good to go. No API knowledge, no code, no dashboard training required.
❓Will it ever make changes to my Tapfiliate account?
No, not yet. Right now the assistant is read-only and built purely for analytics: asking questions, spotting trends, understanding your program. Actions like creating payments or editing affiliate details aren't part of this beta, but they're on our roadmap.
❓Is my data safe?
Yes. Access is authorized through a standard OAuth flow, the same kind you'd use to connect any app to your account, and it's scoped to only what the integration needs. Nothing is shared beyond your own Tapfiliate data.
❓Can I use it with more than one AI assistant at the same time?
Sure. Just remember each assistant is connected separately, so if you want it in both Claude and Cursor, for example, you'll need to run through the setup steps for each one.
❓What if I don't have much activity tracked yet?
The assistant works with whatever data is in your account. If your program is new or lightly used, the insights will be lighter too. The more clicks, conversions, and affiliate activity you build up, the sharper and more useful the answers become.
❓Do I need to phrase my questions a certain way?
Nope. Ask naturally, the way you'd ask a colleague. "Who's underperforming?" and "any affiliates with clicks but no sales?" will both get you where you need to go.
❓What if the numbers seem off?
The assistant only reports what's actually in your Tapfiliate account, it doesn't estimate or fill in gaps. If something looks wrong, it's worth double-checking your tracking setup, since the assistant is only ever as accurate as the data behind it.
❓Can I change the default timeframes, like the 30-day window for inactive affiliates?
Yes, just say so in your question. Something like "show me affiliates who've gone quiet in the last 90 days" will override the default.
Need more help?
If you have questions or need assistance, or have something on your mind to share while using Tapfiliate MCP, feel free to contact us at support@tapfiliate.com. We're happy to help!






