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.

• 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.

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

• 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 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

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

ChatGPT offers another option in Beta to connect MCPs in Developer Mode as part of its main interface instead of a separate GPT app.

For most users, we recommend using our standard setup as described above. For advanced users, follow the steps below.

1. First, you'll need to first enable ChatGPT's Developer Mode. Click the "+" button, "Use connectors", "Add sources", and "Connect more":
   
2. In the Connectors screen, scroll down to "Advanced settings", and enable "Developer mode":
   
3. 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
   
4. Once saved, ChatGPT will direct you to Singular's login page:
   
5. 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:
6. 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:
   

1. In the Claude interface, click on Customize [toolbox icon] in the left-hand navigation pane.
   
2. Click Connectors
   
3. In the Connectors [middle navigation pane] click the Plus sign icon [+] at the top right of the pane.
   
4. Click Add custom connector .
   This will take you to the connector pop-up.
5. In the connector pop-up window:
   • 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
   
6. 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.

7. 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.
8. Log into your Singular account
   
9. You are now connected - you should see the Singular connection in your list of live integrations
   
10. If you click on the Singular integration you will see which APIs the integration is connected to. get_report is the Singular API
    
11. Enter a prompt in the Claude chat interface.
12. Allow Claude to use the external integration
    
13. When using Claude Code, it will automatically be configured with the MCPs added in its UI. Run the following in your terminal to validate it:

    claude mcp list

    And then just run claude in your terminal and ask anything about your data:

1. Ensure you are using the latest version of Cursor which includes Remote MCP support. Download or update at: https://cursor.com/home
2. 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"
         }
       }
     }
   }

3. 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:
   
4. Log into your Singular account:
   
5. Once done, you should be back in Claude's IDE and see Singular's tool as enabled:
6. Lastly, open Cursor's AI Pane (their chat interface), make sure you have the "Agent" mode chosen, and ask anything about your marketing data:

1. Make sure you have the latest version of Gemini-CLI installed by following the instructions here: https://github.com/google-gemini/gemini-cli
2. 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"
           ]
         }
       }
     }
   }

3. 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:
4. Once done, simply ask anything about your marketing data, and allow Gemini to call Singular's tools:

1. Ensure you are using VS Code version 1.101 or higher. Download or update at:
   https://code.visualstudio.com/updates/
2. 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"):
   
3. Open your Visual Studio Code IDE Settings, go to the Chat settings under Features, and make sure that MCP is Enabled:
   
4. 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.
5. Log into your Singular account:
   
6. Once done, you should be back in the VS Code IDE and see Singular's MCP installed under your Extensions menu:
7. Lastly, open the VS Code Copilot chat interface, make sure you have the "Agent" mode turned on, and ask anything about your marketing data:

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

• 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.

• 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

• 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

  

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.

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

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

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