API

MCP Server

Workshop Recording

Claude Code for SEO: From Setup to Insights

Watch Guifré Ballester & Anastasia Kotsiubynska demo the SE Ranking MCP Server live — content briefs, AI Search share of voice, competitive analysis, and building SEO tools with plain English prompts.

Recorded Feb 24, 2026 · 55 min

The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your SE Ranking data in a simple and secure way.

Connect to our MCP server natively in Claude, Cursor, and other clients or use the mcp-remote module for backwards compatibility with clients that do not support remote MCP.

SE Ranking’s MCP server follows the authenticated remote MCP spec, so the server is centrally hosted and managed. The SE Ranking MCP server has 160+ tools available for keyword research, backlink analysis, domain analysis, website audits, AI search visibility, SERP analysis, and project management, with more functionality on the way, and feedback on its functionality is welcomed.

Setup Instructions

General

Our MCP server supports Streamable HTTP transports. This transport uses OAuth 2.1 with dynamic client registration for authentication at the following address:

Copy
https://api.seranking.com/mcp

For instructions for specific clients, read on.

Claude

Claude.ai (Web)

1. Navigate to the connectors page, click + and select Add custom connector

2. Set Name to SE Ranking

3. Set Remote MCP server URL to https://api.seranking.com/mcp

4. Click Add. SE Ranking will appear under Not connected.

5. Select SE Ranking and click Connect to authorize.

Claude Desktop

1. Open Claude Desktop and go to Customize > Connectors

2. Click + and select Add custom connector

3. Set Name to SE Ranking

4. Set Remote MCP server URL to https://api.seranking.com/mcp

5. Click Add. SE Ranking will appear under Not connected.

6. Select SE Ranking and click Connect to authorize.

Claude Code

Copy
claude mcp add --transport http se-ranking https://api.seranking.com/mcp

Then run /mcp once you’ve opened a Claude Code session to go through the authentication flow.

Codex

The setup steps for the MCP server are the same regardless of whether you use the IDE Extension or the CLI since the configuration is shared.

Configuration via CLI:

Run the following command in Terminal:

Copy
codex mcp add se-ranking --url https://api.seranking.com/mcp

This will automatically prompt you to log in with your SE Ranking account and connect it to your Codex.

Note: If this is the first time you are using an MCP in Codex you will need to enable the rmcp feature for this to work. Add the following into your ~/.codex/config.toml:

Copy
[features]
experimental_use_rmcp_client = true

Configuration through environment variables:

1. Open the ~/.codex/config.toml file in your preferred editor.

2. Add the following:

Copy
[features]
experimental_use_rmcp_client = true

[mcp_servers.se-ranking]
url = "https://api.seranking.com/mcp"

3. Run codex mcp login se-ranking to move through the authentication flow.

Cursor

Add the following to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

Copy
{
"mcpServers": {
"se-ranking": {
"url": "https://api.seranking.com/mcp"
}
}
}

Cursor supports Streamable HTTP and OAuth natively. An OAuth window will open on first use to authenticate with your SE Ranking account.

Visual Studio Code

Copy
{
"mcpServers": {
"se-ranking": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.seranking.com/mcp"]
}
}
}

1. Ctrl+P / Cmd+P and search for MCP: Add Server.

2. Select Command (stdio).

3. Enter the following configuration, and hit enter:

Copy
npx -y mcp-remote https://api.seranking.com/mcp

4. Enter the name SE Ranking and hit enter.

5. Activate the server using MCP: List Servers, selecting se-ranking, and selecting Start Server.

v0 by Vercel

To add the MCP to v0, you can install from the connections page.

Windsurf

1. Ctrl+, / Cmd+, to open Windsurf settings.

2. Scroll to Cascade > MCP servers.

3. Select Add Server > Add custom server.

4. Add the following:

Copy
{
"mcpServers": {
"se-ranking": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.seranking.com/mcp"]
}
}
}

Zed

Cmd+, to open Zed settings. Add the following:

Copy
{
"context_servers": {
"se-ranking": {
"source": "custom",
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.seranking.com/mcp"],
"env": {}
}
}
}

Gemini CLI

Add to ~/.gemini/settings.json:

Copy
{
"mcpServers": {
"se-ranking": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.seranking.com/mcp"]
}
}
}

Save and launch Gemini CLI. Authorize when prompted.

Others

Hundreds of other tools now support MCP servers. You can configure them to use SE Ranking’s MCP server with the following settings:

  • Command: npx
  • Arguments: -y mcp-remote https://api.seranking.com/mcp
  • Environment: None

FAQ

Why am I seeing an internal server error when trying to connect?

Enter the following in the Terminal to clear saved auth info: rm -rf ~/.mcp-auth then try again to connect.

Additionally you may need to update to a newer version of Node if required.

What happens when I connect?

A browser window opens to seranking.com where you log in with your SE Ranking account and approve access. After approval, you’re redirected back to your client and the connection is established. If the window doesn’t open automatically, check your client for a URL to paste into a browser manually.

How do I know the connection worked?
  • Claude.ai / Desktop: SE Ranking moves out of Not connected and its tools become available in chats.
  • Claude Code: Run /mcp and confirm se-ranking shows as connected with 160+ tools.
  • Cursor, VS Code, Windsurf, Zed: The server appears as connected in the MCP panel and tools are listed.
  • All clients: Try a prompt like “Using SE Ranking MCP, give me traffic for seranking.com in the US.” If it returns real data, it works.
I’m using WSL on Windows, and seeing an error

WSL can have issues with the OAuth redirect. Configure the server in your client’s Windows-side config file instead, or run the setup from PowerShell:

Copy
{
"mcpServers": {
"se-ranking": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.seranking.com/mcp"]
}
}
}
Does the MCP support Streamable HTTP?

Yes, at the https://api.seranking.com/mcp endpoint.

Can I authenticate with my own API keys or OAuth access tokens?

The MCP server supports passing OAuth tokens and API keys directly in the Authorization: Bearer <your-token> header instead of using the interactive authentication flow.

You can use this to interact with the MCP server programmatically, provide read-only access through a restricted API key, or integrate with an existing SE Ranking OAuth application without an extra authentication hop.

No tools appearing after connecting?
  • Verify your SE Ranking account has API access at the API Dashboard.
  • Run /mcp in Claude Code to check live connection status.
  • Try removing and re-adding the server.

If you need further assistance, contact us at [email protected].


Resources


Video: SE Ranking SEO MCP in Action

See how the MCP server enables competitor analysis and fast keyword research using AI assistants.

Learn how SE Ranking’s API can boost your SEO!

Hi! Meet our product experts!

One of them will walk you through the API and show you how to get the most out of it.

  • Enjoy a tailored demo on integrating rich, structured SEO data into your stack.
  • Pin down every tech detail live—auth, endpoints, rate limits, data formats.
  • Compare usage tiers and pricing so you can unlock maximum data value.

Request a free demo to see our tools and integrations in action

By clicking this button, you agree to SE Ranking’s
Terms of Services and Privacy Policy.