Semrush MCP

Jump to Use Semrush API data in your AI toolsUse Semrush API data in your AI tools

Jump to Semrush MCP server overviewSemrush MCP server overview

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, VS Code, and ChatGPT. For example, in ChatGPT, you can use the Semrush app to work with Semrush data directly in your chats.

Jump to What you get with the Semrush MCPWhat you get with the Semrush MCP

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

Jump to Get Semrush MCP accessGet Semrush MCP access

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

  • 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 ›
  • 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 ›
  • 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.

Jump to Use casesUse cases

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.

Jump to API unit consumptionAPI unit consumption

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:

Jump to Set up Semrush MCP serverSet up Semrush MCP server

Jump to MCP server endpointMCP server endpoint

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

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

Jump to AuthenticationAuthentication

Semrush MCP supports two authentication mechanisms:

Jump to OAuthOAuth

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.

Jump to API keyAPI 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.

Jump to Client-specific setupClient-specific setup

Different MCP clients require different configuration formats:

Jump to ClaudeClaude

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://mcp.semrush.com/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.

Jump to Claude CodeClaude 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://mcp.semrush.com/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.

Jump to ChatGPTChatGPT

Semrush MCP is available as an official Semrush ChatGPT app.

The app consumes API units from your Semrush API subscription, and there are no additional ChatGPT fees.

Jump to Enable Semrush app from Apps listEnable Semrush app from Apps list

  1. Navigate to Account → Settings → Apps.
  2. Find and select Semrush.
  3. Click Connect to enable the app.
  4. In the modal, click Continue. You’ll be redirected to a permission screen where Semrush requests access to your Semrush account for the app. Review the access details, then click Approve. The app will be enabled.

To use the Semrush app within ChatGPT chats, tag it directly as @Semrush.

Jump to CursorCursor

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

Semrush MCP configuration (JSON)
JSON
{
  "mcpServers": {
    "semrush": {
      "url": "https://mcp.semrush.com/v1/mcp"
    }
  }
}

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.

Jump to VS CodeVS 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:
Semrush MCP configuration (JSON)
JSON
{
  "servers": {
    "semrush": {
      "url": "https://mcp.semrush.com/v1/mcp",
      "type": "http"
    }
  }
}

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.

Jump to TroubleshootingTroubleshooting

Jump to OAuth authentication problemsOAuth 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.
  • If you encounter a 400 error, try clearing your browser cookies and restarting the authentication flow. If the issue persists, contact Semrush Customer Support.

Jump to Connection issuesConnection issues

  • Verify that the Semrush MCP server URL is correct: https://mcp.semrush.com/v1/mcp.
  • Check your client’s MCP configuration syntax.

Jump to Issues querying dataIssues 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.

Jump to Missing toolsMissing 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.

Last updated: February 3, 2026

Was this page helpful?