Semrush MCP

How to Install and Use Semrush MCP

Semrush MCP is a tool that helps AI programs like Claude, ChatGPT, and VS Code get data from Semrush APIs easily. It connects AI to Semrush data, so you can ask questions about SEO, traffic, or competitors and get quick answers. Here’s a simple guide on how to install and use Semrush MCP with examples.

Step 1: Know the MCP Server Endpoint

Before setting up anything, you need to know where Semrush MCP lives online. The server URL (endpoint) is the web address your AI tool will use to talk to Semrush MCP.
The server URL you need is:

https://mcp.semrush.com/v1/mcp

Make sure your AI tool can connect to this address.

Step 2: Understand Authentication Options

Semrush MCP keeps your data safe by requiring login or an API key. There are two ways to authenticate:

OAuth is the default and easiest way. When your AI connects using OAuth, it will open a Semrush login page to sign in. No extra setup needed.

API Key is for tools that don't work with OAuth. You have to send the API key in the HTTP request header like this:

Authorization: Apikey YOUR_API_KEY

Get your API key from Semrush’s Get API key guide.

Step 3: Add Semrush MCP to Your AI Tool

Each AI tool has its own way to add Semrush MCP. Here are some examples:

For Claude (Browser or Desktop)

To connect Semrush MCP:

1. Go to Settings → Connectors → Add custom connector.
2. Name it and enter this URL:
   https://mcp.semrush.com/v1/mcp
3. Save it.

The tool will take you through the OAuth login automatically.

For Claude Code (Terminal)

If you use Claude Code, open your terminal and run this command:

claude mcp add semrush https://mcp.semrush.com/v1/mcp -t http

Then:

• Open Claude Code and type /mcp.
• Choose Semrush MCP from the list.
• Click Authenticate and sign in on Semrush with OAuth.

For VS Code

To use Semrush MCP in VS Code:

1. Create a file called .vscode/mcp.json inside your project.
2. Add this code inside the file:

{
  "servers": {
    "semrush": {
      "url": "https://mcp.semrush.com/v1/mcp",
      "type": "http"
    }
  }
}

1. Save it.

When VS Code needs to access Semrush MCP, it will open the login page for OAuth.

For ChatGPT

ChatGPT users can find Semrush MCP in the Connectors list if they are in supported countries (like the USA). Just:

• Go to Account → Settings → Apps & Connectors.
• Find Semrush MCP and click Connect.
• Approve permission on the login screen.

If you are in a region without direct support, you can enable Developer Mode and add Semrush MCP manually as a custom connector with this MCP server URL and OAuth authentication.

Step 4: Use Semrush MCP in Your AI Chats

Once set up, you can ask your AI tool questions like:

• "List domains in the human resources industry for July 2025."
• "Who’s winning traffic among streaming services in Germany in July 2025?"

Your AI tool will use Semrush MCP to fetch this data automatically.

---

That’s it! By following these simple steps, you can connect Semrush MCP with your favorite AI tools and get powerful SEO and traffic data directly in your chats or code editors.