Important!
All MCP API tokens generated before March 10, 2026, 19:00 UTC have been revoked. If your token was generated before this date, please regenerate it.
At a glance: AppsFlyer MCP connects your AppsFlyer data to any large language model (LLM), like Claude or VS Code. Ask questions, get performance insights, and take action directly in your AI chat.
Disclaimer
The AppsFlyer MCP Server is a service currently in Beta phase, provided by AppsFlyer for evaluation purposes.
By using it to connect third-party AI tools, you agree that AppsFlyer has no responsibility or liability for such tools, their outputs, results, performance, operation, legality, or reliability. AppsFlyer does not control, endorse, or verify these tools or their results and expressly disclaims all warranties, express or implied, relating thereto. AppsFlyer is not responsible for data storage, retention, processing, or use by such tools; you are solely responsible for ensuring compliance with applicable laws and your own internal policies. You represent you have all necessary rights and consents to connect these tools to the MCP Server and provide them access to your data. The service is provided “as-is” for supported use cases only; use outside this scope is at your sole risk. Use is subject to the terms of the Master Services Agreement, or if a definitive agreement has been signed, then the terms of such agreement.
What is AppsFlyer MCP?
AppsFlyer MCP lets you securely connect LLMs to the AppsFlyer platform so you can interact with your marketing data through simple conversation. The AppsFlyer MCP helps you make smarter, faster decisions based on real-time data.
With MCP, you can:
- Get instant campaign performance, trends, and KPIs information.
- Compare metrics like ROAS, installs, and LTV.
- Audit and troubleshoot OneLink templates, links, and Audiences connections.
- Retrieve setup guidance or product documentation.
Setting up the AppsFlyer MCP
The AppsFlyer MCP can be connected to a variety of LLM clients. Currently, supported channels include:
- Claude chat and code: Supported on Pro, Max, Team, and Enterprise plans on web and desktop.
- Cursor IDE: Supported. Add MCP servers per project or globally
- VS Code
- ChatGPT: Supported on all plans
- Gemini CLI
Note: Some chat platforms might require admin approval to connect the MCP. If you encounter restrictions or don’t see the implementation steps described below, contact your IT team.
Since this is a new technology, implementation details are subject to frequent changes. Verify the latest setup steps in the platform’s official documentation if anything looks different from what’s described here.
Claude chat and code
Supported on Pro, Max, Team, and Enterprise plans on web and desktop.
These instructions work on both Claude on the web and desktop.
Set up instructions
Click your name (bottom left) > Settings, or in a new chat, click Search & tools > Manage connectors.
Open the Connectors tab.
- Switch to the Organization connectors tab.
- In the connectors sections, click Add connector.
- Connector name: AppsFlyer
- Connector URL: https://mcp.appsflyer.com/auth/mcp
- Click Add.
- Switch to the Your connectors tab.
- In the connectors section, click Connect next to the AppsFlyer connection.
- Log in to AppsFlyer when prompted.
Test instructions
- In any chat window, click the settings button.
- If the AppsFlyer integration was set up properly, you will see a list of tools in the menu.
Note
For Team and Enterprise plan users: Only Owners or Admins can add org-wide integrations.
Cursor IDE
To enable access to the AppsFlyer MCP server from your local development environment using Cursor IDE, follow these steps:
-
Create or open a configuration file depending on the scope:
-
Global config:
~/.cursor/mcp.json -
Project-specific config:
.cursor/mcp.json
-
Global config:
-
Add the following entry under the
mcpServersfield in your JSON file:{ "mcpServers": { "appsflyer": { "url": "https://mcp.appsflyer.com/auth/mcp" } } } -
Restart Cursor IDE to apply the new configuration.
- Authenticate when prompted via login, to gain access to the MCP services.
VS Code
Press
Cmd+Shift+PorCtrl+Shift+Pto open the Command Palette.Select Configure MCP Servers.
In
.vscode/mcp.json, add:{ "appsFlyer": "https://mcp.appsflyer.com/auth/mcp" }Save the file and restart Copilot Chat.
ChatGPT
There are two ways you can use ChatGPT with AppsFlyer.
- Custom GPT - Best for simplicity & scale — a one-click AppsFlyer assistant, accessible to any ChatGPT customer (including free users).
- MCP in ChatGPT - Best for power users who want to integrate AppsFlyer data into any ChatGPT conversation and bring other data into the conversation. Accessible for ChatGPT Pro, Business, or Enterprise accounts.
Custom GPT - Available for all packages, including the Free plan
How to add the AppsFlyer custom GPT
- Click this link: AppsFlyer custom GPT to add the custom GPT to your account.
- For easy access, it is recommended to save the GPT to your sidebar.
How to use the custom GPT
- Open the custom GPT.
- Start asking questions such as:
“Show me my Meta campaign performance from last week.”
MCP in ChatGPT - Supported for ChatGPT users on all paid plans
Prerequisite - Admin needed
Add a connector and publish it to your organization.
- Name: AppsFlyer MCP
- URL: https://mcp.appsflyer.com/auth/mcp
- Authentication: OAuth (default)
Visit the OpenAI instructions to learn more about how to add a custom connector.
Using the AppsFlyer connector in ChatGPT
First time connecting:
- In ChatGPT, navigate to the Sources panel (Settings > Apps & Sources > AppsFlyer MCP).
- Connect to the AppsFlyer MCP.
- Follow the steps to connect and sign in using your AppsFlyer credentials.
Following times:
- In any chat, click the More button (⚙️ or + icon next to the input box).
- Select Sources (or Connectors, depending on your UI version) and turn on the AppsFlyer connection.
-
Once enabled, you can start asking questions such as:
“Show installs by campaign in the last 7 days.”
For security, the AppsFlyer MCP disconnects every 10 hours. To reconnect, follow the steps above.
Gemini CLI
To add the AppsFlyer MCP to Gemini CLI:
-
Add the AppsFlyer MCP server:
In Terminal, run:
gemini mcp add appsflyer https://mcp.appsflyer.com/auth/mcp -t httpThe
-t httpflag specifies the transport type for the connection. -
Start Gemini CLI:
gemini -
Authenticate with AppsFlyer MCP:
In the Gemini CLI prompt, typeauthand press Enter. -
Complete the login flow:
Complete the authentication flow in your browser, and then return to the terminal. -
Ask AppsFlyer questions:
For example:What apps are in my AppsFlyer account?
Troubleshoot authentication issues
If authentication fails:
-
Start Gemini CLI in debug mode:
GEMINI_LOG_LEVEL=debug gemini - In the Gemini CLI prompt, type
authagain and press Enter.
Third-party and self-hosted platforms
Use your MCP token to authenticate third-party or self-hosted systems with AppsFlyer MCP.
This enables automation and AI integrations with platforms like n8n, Make, or your own LLM-powered agents.
The MCP token is an account-level bearer token that inherits the permissions of the admin who created it.
You can access and manage it from Security Center → AppsFlyer Tokens (admin only)
MCP connection details
To connect your automation or agent platform to AppsFlyer MCP, use the following configuration:
Auth Type: Bearer Token
Base URL / Endpoint:
https://mcp.appsflyer.com/auth/mcpBearer Token: Your personal MCP token (generated in AppsFlyer → Security Center → AppsFlyer Tokens)
Note
Never share or publish your token publicly. Treat it as a private credential. Your MCP token grants direct access to your MCP environment.
Example use cases
| Catagory | Example |
|---|---|
| Custom Agents | Build an AI agent that uses MCP to fetch data, analyze it, and send recommendations. |
| LLM integrations | Let a self-hosted LLM query campaign performance metrics via MCP. |
For a quick start guide on how to build an agent with n8n / Make.com + AppsFlyer MCP, check out our blog.
To start building agents using third-party tools quickly, you can use these two templates.
Other platforms
By default, only the LLMs listed above are enabled. If you'd like to connect a different platform not listed, contact your CSM or send an email to hello@appsflyer.com.
Using AppsFlyer MCP
Use cases and prompts
The AppsFlyer MCP gives you a set of tools and resources designed to help you retrieve marketing analytics, performance insights, and perform configuration tasks.
Important!
Answers generated through the AppsFlyer MCP are only reliable when used for the supported use cases listed below. Responses outside of these use cases have not been validated by AppsFlyer and may be inaccurate or misleading. We cannot guarantee the precision or correctness of AI-generated answers that fall outside the intended scope of the AppsFlyer MCP integration.
Some example use cases and prompts are:
Analyze performance
Explore aggregated marketing performance data in real-time. You can identify top and low-performing campaigns, run comparisons, spot trends, and uncover insights to help guide decision-making.
Prompt: "What were my top media sources in the US last week for Mypets.android.com?"
Expected AI response: The AI retrieves top-performing media sources, including installs, revenue, and ROAS.
Prompt: "What is the best campaign in terms of ROAS where total installs are at least 5000?"
Expected AI response: The AI identifies and ranks campaigns meeting the criteria with performance insights.
Prompt: "How many installs did we have yesterday in China for Mypets.android.com app?"
Expected AI response: The AI fetches the number of installs in China for that day and app.
Prompt: "Please create a summary of the performances of Mypets.android.com app in the last day, segmented by campaign."
Expected AI response: The AI returns a campaign-segmented performance report for that app.
Prompt: “Compare between D1 retention last week vs. week before, group by media source”
Expected AI response: The AI performs a week-over-week comparison of D1 retention rates between last week and the week before, grouped by media source.
Analyze SKAN performance
Gain insights into iOS campaign performance using Apple’s SKAdNetwork framework. Identify top-performing campaigns and analyze KPI trends to support decision-making.
Prompt: "What was the ROI by network for the last month?"
Expected AI response: The AI retrieves ROI results for the selected period and highlights the top networks.
Prompt: "Which campaigns have the lowest CPI?"
Expected AI response: The AI identifies campaigns with the lowest CPI, ranking the top performers.
Prompt: "What were the weekly conversion rates for the event af_subscribed in the last month?"
Expected AI response: The AI provides a week-by-week breakdown of conversion rates for the event, and indicates the overall trend.
Prompt: "Which networks have the highest null rates, and which campaigns under them show the highest null rates?"
Expected AI response: The AI identifies networks with the highest null rates and outlines the specific campaigns contributing most to those rates.
OneLink management
Query and audit your OneLink templates and links to ensure consistent routing and accurate user journeys. Helps you troubleshoot issues and verify link setups at scale.
Prompt: "Audit the 'HolidayPush2025' template and show all links with parameters."
Expected AI response: CSV table with short links and associated parameter values.
Prompt: "Why does this OneLink redirect to the App Store for existing users?"
Expected AI response: Troubleshooting insight combining link parameters and fallback logic.
Prompt: "List all QR-enabled OneLinks for app TravelBuddy."
Expected AI response: A list of generated OneLinks with QR links and associated metadata.
Knowledge base and developer support
Quickly access AppsFlyer documentation and DevHub resources. Get accurate answers about SDK setup, product behavior, and measurement logic, directly in your AI chat.
Prompt: "How do I set up in-app event deduplication on Android?"
Expected AI response: The AI provides setup steps, code snippets, and best practices.
Prompt: "What’s the attribution lookback window for TikTok installs?"
Expected AI response: Explanation based on the latest platform-specific attribution rules.
Prompt: "What’s the best way to optimize my App's ROAS using AppsFlyer?"
Expected AI response: The AI outlines strategic levers like segmentation, partner optimization, and LTV measurement best practices.
Apps management
Understand your apps at a glance by retrieving key configuration details such as attribution windows, session timeouts, re-engagement settings, and more. Allowing you to audit and compare app settings across your portfolio to ensure consistency, improve governance, and quickly identify configuration-driven discrepancies in your measurement data.
Prompt: "What is the attribution window set for my gaming apps?"
Expected AI response: A list of apps with their configured attribution windows, highlighting any deviations from the standard.
Prompt: "In which of my apps do I have a different lookback window?"
Expected AI response: The AI surfaces apps with non-standard lookback windows and shows their configured values.
Prompt: "Please list all of my iOS pinned apps that are active."
Expected AI response: A list of pinned iOS apps that are currently active, including app IDs and names.
Prompt: "What is the current session timeout setting for the AppsFlyer gaming app and could it affect my re-engagement from being attributed?"
Expected AI response: The AI returns the session timeout setting and explains its impact on re-engagement.
Audiences management
Gain instant visibility into audience structure, ownership, partner connections, and active tests. Streamlines cross-functional campaign management.
Prompt: "Give me all active audiences for the FinancePro app."
Expected AI response: List of audiences with metadata like creation date, owner, and partners.
Prompt: "Who last updated the audience 'Churned Users - Tier A'?"
Expected AI response: User ID or email with timestamp of the last modification.
Prompt: "List all audiences currently in a split test with Meta and TikTok."
Expected AI response: List of active audiences with test configuration and split percentages.
Feedback tool
Please submit feedback about your experience using the AppsFlyer MCP directly through the assistant interface. It will help us improve and shape the future of the product.
Prompt: “The analytics provided in the analysis tool are amazing — super helpful for our decision-making. I’d love to see also in-app events measurements added as an option in the analysis.”
Expected AI response: The AI submits the message information to the AppsFlyer MCP product team.
Cost configuration integration
Gain full visibility and control over your cost data with the Cost Configuration MCP.
This integration helps you maximize cost coverage, detect integration gaps early, and ensure that cost data remains complete and accurate across all ad networks.
With consistent and reliable cost data, you can make faster, more confident business decisions.
Prompt: “What active cost integrations do I have in my AppsFlyer account?”
Expected AI response: Lists all enabled cost integrations in the user’s AppsFlyer account along with their linked app IDs and current status.
Prompt: “Show me the issues I have in my active cost integrations.”
Expected AI response: Displays a list of active (enabled) cost integrations that had issues in the last 7 days, ordered by ad network and connected apps. If customer action is required, it will be clearly indicated.
Prompt: “Which cost integrations should I connect based on my recent attribution data?”
Expected AI response: Shows ad networks that support cost integration but are not yet connected, ranked by traffic volume in recent attribution data (by app).
Ad revenue integrations
Gain full visibility and control over your ad revenue integrations using AppsFlyer MCP.
You can use MCP to confirm which ad revenue integrations are enabled, monitor their health, detect gaps early, and keep ad revenue data flowing consistently across your apps and monetization partners.
With reliable integration statuses, you can identify issues faster and reduce the risk of ad revenue data loss.
Prompt: "What active ad revenue integrations do I have in my AppsFlyer account?"
Expected AI response: Lists all enabled ad revenue integrations in your AppsFlyer account, including the connected apps (app IDs), and the current integration status for each partner.
Prompt: "Show me the issues I have in my active ad revenue integrations."
Expected response: Displays a list of enabled ad revenue integrations that had issues in the last 7 days. Results are grouped by mediation partner, integration type and app. If customer action is required, it will be clearly indicated.
User management and role control
Streamline your AppsFlyer account administration by retrieving comprehensive user and role information. This tool enables administrators to maintain a clear database and ensure proper access controls efficiently.
Prompt: "List any inactive users who haven't logged into AppsFlyer in the last 6 months"
Expected AI response: A filtered list showing users with last log-in dates older than 6 months, or no login at all, including their email addresses, roles, and exact last login timestamps to help identify users for deactivation.
Prompt: "Show me all users grouped by their permissions levels and highlight any admin users."
Expected AI response: Users organized by role types (Admin, team member, Viewer, etc.) with admin users clearly highlighted, showing their associated apps and geographical access permissions.
Prompt: "One of the team members has complained they can't log into AppsFlyer. Can you check if their user exists and what their current status is?"
Expected AI response: Account verification showing whether the user exists, their current role, associated apps, last login date, and any potential access restrictions.
Prompt: "Which users have access to more than 5 apps, and what are their roles?"
Expected AI response: A list of users with extensive app access, their roles, and the complete list of apps they can access. This can be used for identifying power users or potential over-provisioning.
Other information
Privacy and security
- Authentication: Secure AppsFlyer login required. Credentials are never exposed to the AI tool.
- Access Control: All API access is governed by your AppsFlyer user role.
- Data Use: Data is encrypted, processed in real time, and never stored.
- Compliance: The AppsFlyer MCP adheres to these same standards as AppsFlyer. Using the AppsFlyer MCP server requires your opt in and has an easy opt out option.
Tool mapping
By default, all tools are enabled. We recommend keeping them enabled to ensure full functionality and prevent issues during use.
Each tool is mapped to a functional category, such as Analyze performance, apps management, or OneLink management. Some categories may include multiple tools.
See the table below for the complete list of tools and their category mappings.
| Category | Tool | Description |
|---|---|---|
| Analyze performance | fetch_aggregated_data | Retrieves aggregated dashboard data with custom date ranges, groupings, metrics, and filters. |
| Apps management | get_apps | Lists all permitted apps organized by pinned/unpinned status with transfer requests. |
| get_app_settings | Gets all app configuration settings including attribution windows, privacy controls, session management, and platform-specific configurations. | |
| Cost configuration integration |
get_active_cost_integrations list_cost_supported_media_source |
Get a clear overview of the active cost integrations status alongside missing cost integrations in your account to make the cost reporting more complete and accurate. |
| Ad revenue integration |
list_adrevenue_supported_media_sources get_active_adrevenue_integrations |
Check which integrations are enabled, monitor their health, detect configuration gaps, and ensure ad revenue data is consistently sent across apps and monetization partners. |
| SKAN performance | skan_get_app_data | Retrieves aggregated SKAN performance data. Data can be grouped by network, campaign, or event, and analyzed across custom date ranges. |
| OneLink management | get_onelink_templates | Lists all OneLink templates (foundational routing configurations). |
| get_onelink_template_links | Gets all OneLink links created from a specific template. | |
| get_onelink_details | Gets comprehensive configuration details for a specific OneLink. | |
| Audiences management | list_active_audiences | Lists all active audiences that are calculated daily. |
| list_audiences_connections | Lists all advertising partner integrations for audience data. | |
| get_audience_connections | Gets partner connections for a specific audience. | |
| Knowledge base and developer support | get_public_knowledge | Search AppsFlyer Knowledge Base and DevHub for documentation. |
| Feedback tool | send_feedback | Submits feedback about the tools or system. |
| User management and role control | get_users | List users and roles from AppsFlyer. |
Traits and limitations
| Trait | Description |
|---|---|
| Multi-account use | The AppsFlyer MCP uses data from the default account only |
| OneLink links |
|
| Rate limits |
|
| Date range |
|
| Groupings |
|
| App limits |
|
| Supported dimensions |
|
| Aggregated data |
|
| Freshness |
|
Currency and Time Zone |
|
| Disabling MCP |
|
FAQs
Why isn’t the tool working?
Check your permissions. The AI can only access what your AppsFlyer role allows.
Is AppsFlyer MCP secure?
Yes. You log in using your AppsFlyer credentials, and the AI only sees what you’re allowed to access. The connection uses secure APIs, just like our dashboard or standard APIs.
Can Claude or other tools, see my password or use my data to train models?
No. They use a secure token to fetch data and never see your password or use your data for training.
Does the AppsFlyer MCP server store my data or credentials?
No. AppsFlyer MCP acts as a secure proxy. It fetches data in real-time and returns only what’s needed for the query. Nothing is archived or stored long-term.
Who can set up the integration in our company?
- Claude (Team/Enterprise): Org Owners/Admins must add it. Then any user can connect their account.
- Other IDEs (e.g., Cursor): Anyone can set it up, using their own API key.
Are there any limitations?
The AI can only do what the AppsFlyer MCP supports. Most features are read-only (like fetching analytics). Writing data (like updating settings) may be limited for safety. Large queries may be shortened, and the AI will only access data your API permissions allow. All actions are logged.
What if the AI gives the wrong answer?
It’s rare, but it can happen. Double-check the query and phrasing. You can ask the AI for citations or raw data. Please also let us know so we can work to improve that by sending us feedback using “please send feedback to AppsFlyer” and reach out to AppsFlyer support with details of the query.
I’m getting “authentication failed”, disconnected, or “no permission.” What should I do?
Re-authenticate. Your token may have expired or been revoked (e.g., after a password change). Remove and re-add the integration in your LLM settings, then sign in again.
What Security certifications does AppsFlyer hold?
AppsFlyer is certified under SOC 2 Type 2, ISOs, and CSA STAR.
Do I have to have an AppsFlyer account to use it?
Yes, you should be an AppsFlyer user to use the tool. You can sign up to AppsFlyer here.
Can any user do whatever they want with the AppsFlyer MCP?
No. All access is controlled based on your existing AppsFlyer user roles. Every action is logged via the same audit trails used for AppsFlyer APIs.
The AppsFlyer MCP is not working (disabled)
Please send us feedback using “please send feedback to AppsFlyer” and reach out to the AppsFlyer support team.
If I log in, will the AI have access to all my data stored on the AppsFlyer platform?
No. The AI tool of your choice can only access the data that your user role within AppsFlyer is allowed to view. Your login enables API calls on your behalf, but your credentials are never shared. Data accessed via AppsFlyer MCP is not used to train large language models (LLMs) like Claude. The data retrieved may be shared with the LLM as part of fulfilling your query, but only the specific fields required to generate a response are shared transiently and are not retained for training purposes.
Please note: this connection is to your chosen AI tool, and AppsFlyer does not control whether that tool stores or learns from the data. We recommend reviewing your AI provider’s terms to understand their data usage policies.
Is the beta open to all AppsFlyer users?
Yes, the beta is currently open to all users. Access may be modified or limited by AppsFlyer if necessary.
Why is my MCP is not working
- Your MCP token may have been revoked. If your token was generated before March 10, 2026, 19:00 UTC, it may no longer work.
To restore access:
Log in to AppsFlyer.
Go to Account menu > Security Center > Token Management.
- Locate any API tokens marked Revoked.
- Delete the revoked token.
- Create a new token.
-
Update your MCP client or automation with the new token.
After you update your MCP configuration with the new token, your MCP requests should work again.
- MCP access might be blocked by your AppsFlyer account admin. Check with your admin if you don’t have access to the Account & Profile page.