Overview

What is the Singular MCP?

The MCP (Model Context Protocol) is a framework that lets you pass data from Singular to your LLM clients like ChatGPT and Claude. This enables you to combine all the innate and powerful analysis and visualization capabilities of the LLM with data coming from Singular.

How does it work?

Connect your LLM to the Singular MCP (see instructions below)
Your LLM can now interact with your Singular data. The process is as following:
- When the LLM receives a prompt that is relevant - it will reroute the prompt to the Singular MCP.
- The Singular MCP will translate the prompt to an API query from Singular and generate the results.
- The returned results will be sent back to the user's LLM along with additional context that helps the LLM to understand the data and better analyze it.
- The LLM can further analyze the data depending on the prompts that the user requested.

Which LLMs are currently supported?

ChatGPT
Claude (paid version)
Cursor
Visual Studio Copilot
And any others that support MCP servers (contact our support to request an integration)

Which sets of data are currently supported?

The Singular MCP can return all the data that is available in the main Singular report. This includes both aggregated tracker data coming from the SDK or S2S, as well as the cost data pulled from the networks.
SKAN data is coming soon

What are some example prompts?

What are my top performing campaigns?
Show me a bar chart with my top performing campaigns for the last 30 days
Show me a table with app, source, installs, and D7 ROI for the last 90 days

How to set it up?

ChatGPT - How can I setup ChatGPT with Singular's MCP?

Go to Singular’s GPT page here - you should see the following screen:
Start by asking anything - ChatGPT will automatically ask you to Sign in with Singular’s MCP:
Log into your Singular account:
Once done, you should be back in ChatGPT confirming the connection - now click “Confirm”:
To always allow querying Singular’s MCP, go to “Privacy settings” and update the MCP domain to “Always allow”:
Now you can ask anything about your marketing data:

ChatGPT - Developer Mode (Beta)

First, you'll need to first enable ChatGPT's Developer Mode. Click the "+" button, "Use connectors", "Add sources", and "Connect more":
In the Connectors screen, scroll down to "Advanced settings", and enable "Developer mode":
Now back in the Connectors screen, you can now click a "Create" button and configure Singular's MCP with the following URL:
https://mcp.singular.net/mcp-server/mcp
Once saved, ChatGPT will direct you to Singular's login page:
When back in ChatGPT, you should see a notification that "Singular is now connected". Next, make sure you're still in Developer mode, click the "+" button again, "Developer Mode", "Add sources", and turn on Singular's connector as shown below:
It's time to try it out! Now ask anything about your marketing data, and click "Confirm" once ChatGPT wants to use Singular's tools:

Claude - How can I setup Claude with Singular's MCP?

In the Claude chat interface click on the Search and tools button at the bottom of the chat window
Click Add Integrations
In the Settings → Integration page click on Add Integration
In the Add Integration popup:
- Fill out a name, e.g. Singular (this will be what appears in the Claude UI later)
- The Integration URL is: https://mcp.singular.net/mcp-server/mcp
The Singular integration should now appear in the list.

Note: If the integration does not appear with a "Connect" button next to it, wait 30 seconds, or try to refresh Claude.
Click on the Connect button:

Note: If you received an "Invalid authorization" error from Claude after clicking Connect, it might mean that you're not logged-in to Claude on your browser. Try to login to https://claude.ai/ first and then click Connect again.
Log into your Singular account
You are now connected - you should see the Singular connection in your list of live integrations
If you click on the Singular integration you will see which APIs the integration is connected to. get_report is the Singular API
Enter a prompt in the Claude chat interface.
Allow Claude to use the external integration

Cursor - How can I setup Cursor with Singular's MCP?

Ensure you are using the latest version of Cursor which includes Remote MCP support. Download or update at: https://cursor.com/home
Go to Singular's page in Cursor's MCPs directory and simply click "Add to cursor":
https://cursor.directory/mcp/singular
Alternatively, you can add it manually in Cursor's settings by going to "Tools & Integrations", clicking "New MCP Server", and updating the opened mcp.json file with the following:
```
{
  "mcpServers": {
    "singular-mcp": {
      "url": "https://mcp.singular.net/mcp-server/mcp",
      "transport": "http",
      "auth": {
        "type": "oauth",
        "loginUrl": "https://app2.singular.net/login"
      }
    }
  }
}
```
Once Singular's MCP was added, you should be back in the Tools & Integrations section and see it showing as a new tool. Next, click the "Needs login" link to start the authentication flow:
Log into your Singular account:
Once done, you should be back in Claude's IDE and see Singular's tool as enabled:
Lastly, open Cursor's AI Pane (their chat interface), make sure you have the "Agent" mode chosen, and ask anything about your marketing data:

Gemini CLI - How can I setup Gemini CLI with Singular's MCP?

Make sure you have the latest version of Gemini-CLI installed by following the instructions here: https://github.com/google-gemini/gemini-cli

To add Singular's MCP, add the following in your ~/.gemini/settings.json file:


{
  "mcpServers": {
    "singular-mcp": {
      "httpUrl": "https://mcp.singular.net/mcp-server/mcp",
      "oauth": {
        "enabled": true,
        "authorizationUrl": "https://mcp.singular.net/oauth_server/authorize",
        "tokenUrl": "https://mcp.singular.net/oauth_server/token",
        "clientId": "Gemini",
        "clientSecret": null,
        "scopes": [
          "mcp:read"
        ]
      }
    }
  }
}

Once Singular's MCP was added, start gemini-cli by running "gemini" in your terminal, and run the following: /mcp auth singular-mcp
Login to Singular, and go back to the Gemini CLI to make sure you're authenticated:
Once done, simply ask anything about your marketing data, and allow Gemini to call Singular's tools:

Visual Studio Code (Copilot) - How can I setup VS Code with Singular's MCP?

Ensure you are using VS Code version 1.101 or higher. Download or update at:
https://code.visualstudio.com/updates/
You must have an active GitHub Copilot subscription. Your GitHub organization admin must enable the "MCP servers" feature in your workspace (find it in Github's Copilot settings under "Policies"):
Open your Visual Studio Code IDE Settings, go to the Chat settings under Features, and make sure that MCP is Enabled:
In the VS Code Command Palette (Shift+Command+P) choose the "MCP: Add Server", pick the "HTTP" option, and enter the following MCP URL:
https://mcp.singular.net/mcp-server/mcp

Once done, VS Code will start the authentication process.
Log into your Singular account:
Once done, you should be back in the VS Code IDE and see Singular's MCP installed under your Extensions menu:
Lastly, open the VS Code Copilot chat interface, make sure you have the "Agent" mode turned on, and ask anything about your marketing data:

FAQ

Which LLM or model should I use?

Each LLM has their own strengths - we encourage testing multiple options and see what works best for your questions.

Are there limitations on the amount of data returned by the MCP?

Yes, LLM clients have limits on how much data MCPs can return in their response.
ChatGPT for example is limited up to 50k characters per query to prevent issues, while Claude supports up to 100k characters.

Can I view or update the available fields by Singular's MCP?

Yes. By default, Singular's MCP returns the most common metrics and dimensions relevant for your account. But in some cases, you might be missing a specific field that isn't in the default list.
For these case, Singular's MCP offers useful tools to view and update the relevant fields for you:
- get_supported_fields - returns all fields currently available by the MCP
- update_supported_fields - adds or removes additional fields from the MCP
For example, if you can't find a field named "ABC" in your returned data, try the following:
- "Show all my supported fields" - see the full list and check if ABC is available under a different name
- "Add 'ABC' to my supported fields" - if the name exists in Singular, it will be added as a relevant field
- "Show my ABC for the last 30 days" - you should now receive the relevant results

ChatGPT error: "Your workspace owner hasn't approved this GPT"

If you're using a ChatGPT workspace, your account might have third-party GPTs disabled. To enable Singular's GPT to work, ask your admin to enter the Workspace GPT Settings below and make sure it's enabled:
https://chatgpt.com/admin/gpts

Privacy & Data Usage

Will data passed through MCP be used for training?

No. By default, any data passed into our MCP is not used for model optimization or training by Singular. Singular ensures that your contextual data remains isolated to your environment and is only used to serve your own queries.

Does the MCP have access to the user level data?

No - currently the MCP can only access the aggregated data such as it appears in the Singular main report page.

Are permissions enforced in the Singular MCP?

Yes - the MCP has the same access to data as the user that was used to connect the Singular MCP integration with the LLM.

Is context data encrypted?

Yes. All context data is encrypted both in transit and at rest using industry-standard encryption protocols.