The Model Context Protocol (MCP) server gives AI assistants a standard way to read and work with your Zerply workspace. Connect once with OAuth, ask questions in plain language, and get answers from your real visibility data, Signals reports, content, and keyword research instead of copying numbers out of dashboards.

Zerply's MCP server is centrally hosted at `https://api.zerply.ai/mcp` and uses OAuth sign-in. The first time an app connects, your browser opens so you can sign in and approve access. After that, the connection stays active until you disconnect it or it expires. Manage linked apps anytime at [app.zerply.ai/mcp](https://app.zerply.ai/mcp).

Everything in Zerply still lives at [app.zerply.ai](https://app.zerply.ai). MCP is optional—use it when you want answers while you are already in chat, without opening another tab.

For better answers once connected, also install the [Zerply agent skill](/docs/agent-skill/). MCP gives your assistant access to your data; the skill teaches it how to use Zerply's tools and workflows reliably.

## Setup instructions

### General

Zerply's MCP server uses Streamable HTTP with OAuth authentication at:

`https://api.zerply.ai/mcp`

**Before you start**

1. A **Zerply account** with at least one workspace. If you have not finished onboarding, start with [Setting Up Your Workspace](/docs/setting-up-your-workspace/).
2. **One supported AI app** installed and working on your computer or browser.

You do not need to know what MCP, OAuth, or JSON mean for most setups. Follow the client section below that matches your app.

**Verify the connection**

After setup, ask your assistant:

> List my Zerply landing pages

or

> Show my Zerply workspaces

If the reply includes **your real site or workspace names**, you are connected. If you only get a generic answer or an error, complete the sign-in step in the browser and try again.

**Manage connections**

Open [app.zerply.ai/mcp](https://app.zerply.ai/mcp) to see which AI apps are linked, whether access is still active, and disconnect any app you no longer use.

| Field | Value |
| --- | --- |
| **Name** | Zerply |
| **Server URL** | `https://api.zerply.ai/mcp` |
| **Authentication** | OAuth (or "Sign in with Zerply"—wording varies by app) |

### Cursor

Cursor is the quickest way to connect. Install in one click or add the server through Settings.

**One-click install (recommended)**

1. Open this page on the computer where **Cursor** is installed.
2. Click **Add to Cursor** below.

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=zerply&config=eyJ1cmwiOiJodHRwczovL2FwaS56ZXJwbHkuYWkvbWNwIn0=)

3. Cursor opens and adds Zerply. Confirm if it asks.
4. In Cursor chat, ask something that uses Zerply data—for example: *"List my Zerply landing pages."*
5. When your browser opens, **sign in to Zerply** and approve access. Return to Cursor.

**Install through Cursor Settings**

Use this if the button does not work or you manage MCP servers manually.

1. Open **Cursor**.
2. Open **Settings** (gear icon or `Cmd + ,` on Mac / `Ctrl + ,` on Windows).
3. Go to **Tools & MCP** in the sidebar.
4. Under **Installed MCP Servers**, click **New MCP Server** (or edit `mcp.json` if Cursor opens it).
5. Paste this block and save:

```json
{
  "mcpServers": {
    "zerply": {
      "url": "https://api.zerply.ai/mcp"
    }
  }
}
```

6. Restart Cursor if it does not pick up the change immediately.
7. Ask a Zerply question in chat and complete **sign-in in the browser** when prompted.

### Claude

Claude can use your Zerply workspace from **Claude.ai** (web) or **Claude Desktop** (Mac/Windows app).

**Claude.ai (web)**

1. Go to [claude.ai](https://claude.ai) and sign in.
2. Open **Customize** (or your profile menu) and find **Connectors**.
3. Click **Add custom connector** (or similar).
4. Fill in:
   - **Name:** `Zerply`
   - **Server URL:** `https://api.zerply.ai/mcp`
5. Click **Add**, then **Connect**.
6. Your browser opens Zerply—**sign in** and **approve** access.
7. Back in Claude, ask: *"List my Zerply landing pages."*

**Claude Desktop (Mac or Windows)**

1. Quit Claude Desktop if it is open.
2. Open the config file in a text editor:
   - **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

   If the file does not exist, create it.
3. Paste this (or merge the `mcpServers` block if the file already has content):

```json
{
  "mcpServers": {
    "zerply": {
      "url": "https://api.zerply.ai/mcp",
      "type": "streamable-http"
    }
  }
}
```

4. Save the file and **restart Claude Desktop**.
5. Start a chat and ask a Zerply question. **Sign in in the browser** when Claude prompts you.

### Claude Code

```bash
claude mcp add --transport http zerply https://api.zerply.ai/mcp
```

Then run `/mcp` once you have opened a Claude Code session to go through the authentication flow. The first Zerply request opens a browser for sign-in.

### ChatGPT

ChatGPT connects to Zerply through a **custom app**. You need **Developer Mode** turned on in ChatGPT settings. If you only use ChatGPT for casual chat and rarely change settings, Claude or Cursor may feel simpler.

**Before you begin**

- ChatGPT account with access to **Apps** and **Developer Mode** (availability can vary by plan and region).
- Willingness to create a custom app—ChatGPT shows extra warnings because you are connecting an external service.

**Create the Zerply app**

1. Open **ChatGPT**.
2. In the left sidebar, go to **Apps**.
3. Open **Settings** (gear icon).
4. Under **Advanced settings**, turn on **Developer mode** if it is off.
5. Click **Create app**.
6. Enter:
   - **Name:** `Zerply`
   - **Description:** `Zerply workspace — visibility, content, keywords`
   - **Connection type:** Server URL
   - **Server URL:** `https://api.zerply.ai/mcp`
   - **Authentication:** OAuth
7. Read the warning, check **I understand and want to continue**, then click **Create**.
8. Click **Connect**. Sign in to Zerply in the browser and approve access.

**Try it**

In a ChatGPT conversation that can use your new app, ask:

> List my Zerply landing pages

or

> Summarize our AI visibility for the last week

After MCP is working, [install the agent skill](/docs/agent-skill/) so your assistant follows Zerply's recommended workflows and tool usage.

## What you can do

Once connected, ask the way you would ask a teammate. You do not need special commands.

| Area | Examples |
| --- | --- |
| **Workspaces** | List teams you have access to |
| **AI visibility** | Mention rates, share of voice, competitor comparisons, tracked prompts, LLM responses, citation decay |
| **AI traffic** | Traffic analytics from AI platforms |
| **Blogs** | List, read, create, update, publish, and unpublish blog posts |
| **Landing pages** | List, read, create, update, publish, and unpublish landing pages |
| **Signals** | Fortnightly AI visibility briefings, verdicts, and recommendations |
| **Keywords** | Keyword cluster reports and cluster details |
| **Foundry** | Site settings, branding, and publishing configuration |

Example prompts:

- *"How did our mention rate change last week?"*
- *"Which of our cited pages are decaying, and what replaced them?"*
- *"Which competitors show up most in our tracked prompts?"*
- *"Summarize our latest Signals report."*
- *"List our landing pages" or "What blogs are still drafts?"*
- *"Summarize our latest keyword cluster report."*
- *"What are our Foundry settings for this site?"*

## FAQ

<details>
<summary>Do I need to understand MCP or OAuth?</summary>

No. Most setups are a few clicks plus one browser sign-in. Use the client section above that matches your app. The reference table under **General** is only if a screen asks for a server URL or authentication type.
</details>

<details>
<summary>How do I know the connection worked?</summary>

Ask *"List my Zerply landing pages"* or *"Show my Zerply workspaces."* If the reply includes your real site or workspace names, you are connected. A generic answer or error usually means sign-in was not completed—open the browser tab, approve access, and try again.
</details>

<details>
<summary>How do I disconnect an AI app?</summary>

Open [app.zerply.ai/mcp](https://app.zerply.ai/mcp) to see linked apps and revoke access. In ChatGPT, you can also remove the custom app from Apps settings.
</details>

<details>
<summary>ChatGPT will not connect or keeps asking me to sign in</summary>

Confirm **Developer Mode** is on and you saved the Zerply app with Server URL `https://api.zerply.ai/mcp` and **OAuth** authentication. Finish approval in the browser tab before returning to ChatGPT. If you get empty or wrong data, check you are signed into the correct Zerply account at [app.zerply.ai](https://app.zerply.ai).
</details>

<details>
<summary>The one-click Cursor button does nothing</summary>

Use **Install through Cursor Settings** instead: add the JSON block under **Tools & MCP**, restart Cursor, and complete sign-in when prompted.
</details>

<details>
<summary>Does Zerply work with other MCP clients?</summary>

Any client that supports remote MCP with Streamable HTTP and OAuth can use `https://api.zerply.ai/mcp`. Add Zerply as a custom remote server and sign in when prompted. Manage all connections at [app.zerply.ai/mcp](https://app.zerply.ai/mcp).
</details>

<details>
<summary>Should I install the agent skill too?</summary>

Yes, if your client supports `SKILL.md` files (Cursor and Claude Code do). MCP connects the data; the [agent skill](/docs/agent-skill/) teaches your assistant how to use Zerply well. Most users get better results with both.
</details>