# Semrush MCP server
> Query Semrush keyword, domain, backlink and traffic data from your AI assistant.
- Listing: https://mcp.tc/i/semrush
- Connect: use the server's own URL `https://mcp.semrush.com/v1/mcp` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: OAuth sign-in
- Category: [Marketing & SEO](https://mcp.tc/c/marketing-seo)
- Vendor: Semrush
- Verified: yes, mcp.tc checked that this is the official server (https://mcp.tc/verify). It says who runs the server, not that it is safe.
- Homepage:
## About
Connects an AI assistant to Semrush API data. The Semrush API documentation covers keyword reports, domain and subdomain overviews, backlink analysis, competitor research and Trends API traffic and market data, which the assistant can use to answer SEO and competitive questions.
The server is hosted at mcp.semrush.com using streamable HTTP. Users sign in through Semrush OAuth, and the operator notes also mention an API key sent as an 'Authorization: Apikey ' header. Semrush API units may apply to requests. The tool list is not published in the probe.
## What it can do
- Look up keyword overview and difficulty data
- Analyze domain organic and paid search performance
- Review backlinks and referring domains
- Find competitors in organic and paid search
- Check website traffic and market data
## Example prompts
- "Show organic search keywords for example.com in the US database"
- "Compare backlink profiles of example.com and competitor.com"
- "What is the keyword difficulty for 'running shoes'?"
- "Summarize website traffic trends for example.com"
## Install
### Claude Code
1. Run this in a terminal, in your project folder:
```bash
claude mcp add --transport http semrush https://mcp.semrush.com/v1/mcp
```
2. Start Claude Code, type `/mcp`, pick **semrush** and choose **Authenticate**. A browser window opens for the Semrush sign-in.
Add `--scope user` to make it available in every project, not just this one.
### Claude Desktop
1. Open **Settings → Connectors** and click **Add custom connector**.
2. Name it **Semrush** and paste this URL:
```url
https://mcp.semrush.com/v1/mcp
```
3. Click **Add**, then **Connect**, and sign in when Semrush asks.
Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.
### claude.ai
1. Open the connector form on claude.ai. This button fills in the name and URL for you:
[Add to claude.ai]() (opens connector settings)
2. Check that the URL reads `https://mcp.semrush.com/v1/mcp` and click **Add**.
3. Click **Connect** and sign in when Semrush asks.
Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.
### ChatGPT
1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**.
2. Go to `chatgpt.com/plugins` and click **+** to create an app for a remote MCP server.
3. Paste `https://mcp.semrush.com/v1/mcp` as the server URL and choose **OAuth**. ChatGPT sends you to Semrush to sign in.
Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts.
### Cursor
[Add to Cursor]() (opens Cursor)
Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):
`mcp.json`:
```json
{
"mcpServers": {
"semrush": {
"url": "https://mcp.semrush.com/v1/mcp"
}
}
}
```
Cursor shows **Needs login** next to the server. Click it to sign in.
### VS Code
[Install in VS Code]() (opens VS Code)
Or from a terminal:
```bash
code --add-mcp '{"name":"semrush","type":"http","url":"https://mcp.semrush.com/v1/mcp"}'
```
Or commit it to the repo in `.vscode/mcp.json`:
`.vscode/mcp.json`:
```json
{
"servers": {
"semrush": {
"type": "http",
"url": "https://mcp.semrush.com/v1/mcp"
}
}
}
```
VS Code asks you to sign in the first time the server starts.
### Devin Desktop
1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):
`mcp_config.json`:
```json
{
"mcpServers": {
"semrush": {
"serverUrl": "https://mcp.semrush.com/v1/mcp"
}
}
}
```
2. Refresh the MCP server list in Cascade and sign in when asked.
Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.
### Codex
```bash
codex mcp add semrush --url https://mcp.semrush.com/v1/mcp
codex mcp login semrush
```
Or edit `~/.codex/config.toml` directly:
`config.toml`:
```toml
[mcp_servers.semrush]
url = "https://mcp.semrush.com/v1/mcp"
```
### Gemini CLI
```bash
gemini mcp add --transport http semrush https://mcp.semrush.com/v1/mcp
```
Then, inside Gemini CLI, run `/mcp auth semrush` to sign in.
This adds it to the current project. Add `-s user` to use it everywhere.
### Any client
Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.
```json
{
"mcpServers": {
"semrush": {
"type": "http",
"url": "https://mcp.semrush.com/v1/mcp"
}
}
}
```
Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.
Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.semrush.com/v1/mcp`.
## Details
- Last checked: 2026-10-03 (reachable, asks for credentials)
- Listed: 2026-10-03
- Updated: 2026-10-04
---
Source: https://mcp.tc/i/semrush (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report