# Singular MCP

> Singular's hosted MCP server: ask your agent about campaigns, installs and ROI, and get answers from your Singular marketing data.

The Singular MCP connects your agent to Singular, the marketing analytics and attribution platform. Ask a question in plain words: Singular turns it into a query on your Singular data and sends back the results with context, so your agent can analyze them and chart them.

What you can do with it
- Run Singular reports from a plain-language question, including SKAN Summary and SKAN Raw reports
- See which dimensions, metrics and cohort metrics you can use, and add a field that's missing
- Check how your apps, data connectors, audience segments, fraud rules, Singular Link domains and SKAN conversion models are set up
- Troubleshoot your data: whether a day's data has arrived from each connector, when connectors next refresh, creative permission errors and exports to your data destinations
- See the change history of your partner configurations
- Get help installing, upgrading or troubleshooting the Singular SDK

How it connects
Singular hosts it at https://mcp.singular.net/mcp-server/mcp. Add that address as a custom connector or MCP server in your agent, then sign in with your Singular account. Singular's guide covers ChatGPT (also through Singular's GPT), Claude and Claude Code, Cursor, Gemini CLI and VS Code with GitHub Copilot.

Good to know
- It works with aggregated data, as on Singular's main report page, not user-level data.
- It sees the same data as the Singular user who connected it.
- Singular says data passed through it isn't used for training.
- Agents limit how much data a server can return in one answer, so ask for focused reports.

- Type: Plugin
- Made by: Singular
- Category: Marketing & SEO
- Formats: Remote MCP
- Version: 1.0.0
- Website: https://support.singular.net/hc/en-us/articles/37923459892507-Singular-MCP
- Page: https://pluginboard.ai/plugins/singular-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.singular.net/mcp-server/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.singular.net/mcp-server/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.singular.net/mcp-server/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.singular.net/mcp-server/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.singular.net/mcp-server/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.singular.net/mcp-server/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22singular-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.singular.net%2Fmcp-server%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http singular-mcp https://mcp.singular.net/mcp-server/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=singular-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5zaW5ndWxhci5uZXQvbWNwLXNlcnZlci9tY3AifQ%3D%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "singular-mcp": {
      "url": "https://mcp.singular.net/mcp-server/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http singular-mcp https://mcp.singular.net/mcp-server/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add singular-mcp --url https://mcp.singular.net/mcp-server/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "singular-mcp": {
      "url": "https://mcp.singular.net/mcp-server/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http singular-mcp https://mcp.singular.net/mcp-server/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.singular.net/mcp-server/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add singular-mcp --url https://mcp.singular.net/mcp-server/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.singular.net/mcp-server/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login singular-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add singular-mcp --url https://mcp.singular.net/mcp-server/mcp
```

If it needs a key: For https://mcp.singular.net/mcp-server/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add singular-mcp --url https://mcp.singular.net/mcp-server/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "singular-mcp": {
      "url": "https://mcp.singular.net/mcp-server/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://mcp.singular.net/mcp-server/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).
