MCP server

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

Everything in Zerply still lives at 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. 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

A Zerply account with at least one workspace. If you have not finished onboarding, start with Setting Up Your Workspace.
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

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

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

Cursor opens and adds Zerply. Confirm if it asks.
In Cursor chat, ask something that uses Zerply data—for example: “List my Zerply landing pages.”
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.

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

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

Restart Cursor if it does not pick up the change immediately.
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)

Go to claude.ai and sign in.
Open Customize (or your profile menu) and find Connectors.
Click Add custom connector (or similar).
Fill in:
- Name: Zerply
- Server URL: https://api.zerply.ai/mcp
Click Add, then Connect.
Your browser opens Zerply—sign in and approve access.
Back in Claude, ask: “List my Zerply landing pages.”

Claude Desktop (Mac or Windows)

Quit Claude Desktop if it is open.
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.
Paste this (or merge the mcpServers block if the file already has content):

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

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

Claude Code

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

Open ChatGPT.
In the left sidebar, go to Apps.
Open Settings (gear icon).
Under Advanced settings, turn on Developer mode if it is off.
Click Create app.
Enter:
- Name: Zerply
- Description: Zerply workspace — visibility, content, keywords
- Connection type: Server URL
- Server URL: https://api.zerply.ai/mcp
- Authentication: OAuth
Read the warning, check I understand and want to continue, then click Create.
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

Summarize our AI visibility for the last week

After MCP is working, install the 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
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
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 competitors show up most in our tracked prompts?”
“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

Do I need to understand MCP or OAuth?

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.

How do I know the connection worked?

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.

How do I disconnect an AI app?

Open app.zerply.ai/mcp to see linked apps and revoke access. In ChatGPT, you can also remove the custom app from Apps settings.

ChatGPT will not connect or keeps asking me to sign in

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.

The one-click Cursor button does nothing

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

Does Zerply work with other MCP clients?

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.

Should I install the agent skill too?

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