> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.spyglass.so/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.spyglass.so/_mcp/server.

# Spyglass MCP

> Connect ChatGPT, Claude, Cursor, and other MCP clients to Spyglass search.

Spyglass MCP connects ChatGPT, Claude, Codex, Grok, Cursor, and any other MCP client to Spyglass search: brands, creatives, insights, landing pages, and public comments.

The hosted server works in any MCP client that supports remote Streamable HTTP and OAuth. No API key is required. Sign in with Spyglass when the client prompts you. Usage draws on the same monthly credits as the rest of Spyglass.

## Install

<input type="radio" name="mcp-client" id="mcp-codex" />

<input type="radio" name="mcp-client" id="mcp-claude" />

<input type="radio" name="mcp-client" id="mcp-claude-code" />

<input type="radio" name="mcp-client" id="mcp-cursor" />

<input type="radio" name="mcp-client" id="mcp-grok" />

![](/_fern-files/spyglass.docs.buildwithfern.com/730508e7487d4e4ba758bfcca3e4cdfd31953938efad6d506acd502858559db3/assets/clients/openai.svg)ChatGPT

![](/_fern-files/spyglass.docs.buildwithfern.com/08d48829113026219e914d8bde9610722d9aed30fb89b1ed89e19b1aff91be70/assets/clients/codex.svg)Codex

![](/_fern-files/spyglass.docs.buildwithfern.com/b0d9b337b3fd947ff467b69c80af23eb312a4f91a3928a00ba9b6d1f8a089f17/assets/clients/claude.svg)Claude

![](/_fern-files/spyglass.docs.buildwithfern.com/55c31d5508b2e0ee82897d099e7f6c19ec4df441479433b44a9e00e13999dc4f/assets/clients/claude-code.svg)Claude Code

![](/_fern-files/spyglass.docs.buildwithfern.com/68c88e317a03fefb7d8ed68b9fe86ef33c0a002765fa6bfc84cdc43d7bb9f4fe/assets/clients/cursor.svg)Cursor

![](/_fern-files/spyglass.docs.buildwithfern.com/1c12697b54625bb65c7183b9ccc0ef07ff083db347567d39191e655a4560a946/assets/clients/xai.svg)Grok

[![](/_fern-files/spyglass.docs.buildwithfern.com/730508e7487d4e4ba758bfcca3e4cdfd31953938efad6d506acd502858559db3/assets/clients/openai.svg)Add to ChatGPT](https://chatgpt.com/plugins)

1. On [ChatGPT Plugins](https://chatgpt.com/plugins), open **Add** and choose **Add custom MCP server**.
2. Name it Spyglass. Under Connection, paste `https://mcp.spyglass.so/mcp`.
3. Choose OAuth, confirm the warning, and select **Create as a plugin**. Install the plugin, then type `@` in a new chat and select Spyglass.

```bash
codex mcp add spyglass --url https://mcp.spyglass.so/mcp
codex mcp login spyglass
```

Run `codex mcp list` to confirm the connection.

[![](/_fern-files/spyglass.docs.buildwithfern.com/b0d9b337b3fd947ff467b69c80af23eb312a4f91a3928a00ba9b6d1f8a089f17/assets/clients/claude.svg)Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector)

1. Choose **Add custom connector**.
2. Name it Spyglass and paste `https://mcp.spyglass.so/mcp`.
3. Complete the browser sign-in, then enable Spyglass in a new chat.

```bash
claude mcp add --scope user --transport http spyglass https://mcp.spyglass.so/mcp
claude mcp login spyglass
```

Run `/mcp` to confirm Spyglass is connected.

[![](/_fern-files/spyglass.docs.buildwithfern.com/68c88e317a03fefb7d8ed68b9fe86ef33c0a002765fa6bfc84cdc43d7bb9f4fe/assets/clients/cursor.svg)Add to Cursor](https://cursor.com/install-mcp?name=Spyglass\&config=eyJ1cmwiOiJodHRwczovL2FwcC5zcHlnbGFzcy5zby9hcGkvbWNwIn0)

This opens Cursor’s install dialog with Spyglass and the MCP URL already filled in. Click **Install**, then **Connect** and sign in.

To add it by hand, use **Settings → Tools & MCP** or `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "spyglass": {
      "url": "https://mcp.spyglass.so/mcp"
    }
  }
}
```

[![](/_fern-files/spyglass.docs.buildwithfern.com/1c12697b54625bb65c7183b9ccc0ef07ff083db347567d39191e655a4560a946/assets/clients/xai.svg)Add to Grok](https://grok.com/connectors)

1. Click **New Connector** and choose **Custom**.
2. Name it Spyglass and paste `https://mcp.spyglass.so/mcp`.
3. Finish the sign-in. Spyglass is available in the next chat.

Using another MCP client? Point it at:

<code>
  [https://mcp.spyglass.so/mcp](https://mcp.spyglass.so/mcp)
</code>

## Tools

| Tool                    | Use it to                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------ |
| `getAccounts`           | Resolve a brand or creator. `type` is optional: `BRAND`, `CREATOR`, or omit for both |
| `searchTaxonomies`      | Find product-category paths to filter media                                          |
| `getMedia`              | Search creatives, or list media for a brand you already resolved                     |
| `getBrandMediaInsights` | Group a brand's media into hooks, personas, angles, or media mix                     |
| `getBrandLandingPages`  | List a brand's top landing pages                                                     |
| `getBrandCampaigns`     | List a brand's campaigns or offers                                                   |
| `getCollabs`            | List an account's collaborations with other brands/creators                          |
| `getComments`           | Fetch public Instagram or TikTok comments on specific posts                          |
| `searchReddit`          | Search recent public Reddit posts and comments                                       |

Resolve a name with `getAccounts` first (`type` is optional), then pass the returned id as `accountId` to `getMedia`, and as `brandId` to the other tools.