SEO

Semrush MCP: setup in Claude, ChatGPT and Cursor

Semrush MCP connects your agent to Semrush's SEO data: keywords, domains, backlinks, competitors and site audits. This guide covers the plans that include it, setup in Claude, Claude Code, ChatGPT and Cursor, how units are spent, and a community server you run yourself.

Jesse Sibley
By , FounderPublished · Last updated · 10 min read

Semrush MCP is Semrush's official MCP server. It connects AI agents such as Claude, ChatGPT and Cursor to Semrush's SEO data: keywords, domain analytics, backlinks, competitors, position tracking and site audits. The server is hosted by Semrush at https://mcp.semrush.com/v2/mcp and signs you in with OAuth or a Semrush API key. You need an eligible Semrush subscription, and every request spends API units from it.

This guide covers which plans include Semrush MCP, how to connect it in Claude, Claude Code, ChatGPT and Cursor, the problems people hit with plan access and unit usage, a community server you run yourself, and example prompts.

What is Semrush MCP?

Semrush MCP is the bridge between your agent and the Semrush API. You ask a question in plain language, and the agent picks a Semrush report, fills in its parameters and runs it. According to Semrush's MCP documentation, it serves data from:

  • The Standard (SEO) API: keywords, domains, organic and paid search, backlinks and competitors
  • The Trends API: website traffic and market data, depending on your Trends API plan
  • The Projects API: data from your existing Semrush projects. It can read projects but not create them or change their settings
Diagram: your agent connects to Semrush MCP with OAuth or an API key and spends your plan's units
Every request spends API units from your Semrush plan.

Rather than one tool per endpoint, the server gives your agent a small set of tools. Discovery tools such as domain_overview, organic_research, keyword_research, competitors_research, backlinks_research, traffic_overview, position_tracking and site_audit find the right report, get_report_schema reads its parameters, and execute_report runs it.

Who Semrush MCP is for

Semrush MCP fits when:

  • You already pay for an eligible Semrush plan and want that data in conversation with your agent
  • Your team uses Semrush daily and wants consistent metrics across the app and your agent
  • You are comfortable watching your API unit balance

It may not fit when:

  • You do not have a Semrush plan and do not want to start one just for MCP
  • You only need SEO data now and then
  • Broad reports would burn through the 50,000 units that come with the entry plans

Which Semrush plans include MCP

Semrush lists these plans for connecting SEO data through MCP:

  • Semrush One Starter, Semrush One Pro+, SEO Classic Pro or SEO Classic Guru: each includes 50,000 API units, which refresh on your subscription renewal date
  • Semrush One Advanced or SEO Classic Business: works with an added API units package (2, 5, 10 or 20 million units)

In October 2026, Semrush's US pricing page listed Semrush One Starter at $199/mo billed monthly. Traffic and market data needs a separate Trends API plan (Basic or Premium), which includes MCP access; Semrush's MCP knowledge base article lists what each plan covers.

To see what you have, open My Profile → Subscription info. The Summary tab shows your Standard and Trends API units.

How to connect Semrush MCP to Claude

Semrush is an official app in Claude:

  1. Open Claude and go to Customize → Connect your apps
  2. Search for Semrush, select it and click Connect
  3. Review the permission screen and click Approve
  4. In a chat, tag the app as @Semrush and ask your question

Semrush MCP in Claude Code

Add the server from your terminal, then run /mcp, select Semrush and choose Authenticate:

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

How to connect Semrush MCP to ChatGPT

Semrush is also an official ChatGPT app:

  1. Go to Settings → Apps
  2. Find and select Semrush, then click Connect
  3. Click Continue, review the permission screen and click Approve
  4. Tag the app as @Semrush in a chat

Semrush says the Claude and ChatGPT apps spend units from your Semrush API subscription, with no extra Claude or ChatGPT fees.

Semrush MCP in Cursor

In Settings → Cursor Settings → Tools & MCP, add this to your MCP configuration:

JSON
{
  "mcpServers": {
    "semrush": {
      "url": "https://mcp.semrush.com/v2/mcp"
    }
  }
}

Cursor opens the Semrush login page to finish OAuth.

Other clients

Semrush's docs also cover VS Code, Lovable and Antigravity, and Perplexity has an official Semrush app, which needs a paid Perplexity account. Semrush's docs say Gemini CLI support is discontinued and point Gemini users to Antigravity instead (checked October 2026).

Using an API key instead of OAuth

OAuth is the default. If your client cannot do OAuth, pass your Semrush API key in the Authorization header in this exact format:

Text
Authorization: Apikey YOUR_API_KEY

Note the Apikey prefix: Semrush's docs do not use Bearer. Your API key is not your Semrush password. Semrush's API access guide explains where to find it.

Common problems and fixes

Your plan does not include MCP access

Symptom: requests fail, or the agent says it cannot reach the data you asked for.

Fix: check My Profile → Subscription info. Semrush One Starter, Pro+, SEO Classic Pro and Guru include API units. Semrush One Advanced and SEO Classic Business need an API units package. Trends data needs a Trends API plan, so traffic and market questions fail without one even if your SEO data works.

Units run out faster than expected

Symptom: your unit balance drops quickly.

Cause: Semrush charges units per line of data returned, and the rate depends on the report. In Semrush's own example, one line of the Domain Organic Search Keywords report costs 10 units for live data and 50 units for historical data. A broad request can return thousands of lines.

Fix:

  1. Be specific. Ask for "the top 50 keywords in the US database" rather than "all keywords".
  2. Always set a result count, a database and filters.
  3. Avoid historical data unless you need it.
  4. Keep related questions in one chat so the agent can reuse what it already fetched.
  5. Check your balance in My Profile → Subscription info.

OAuth problems

  • If you see redirect URI ... is not allowed, contact Semrush support with your client's name and redirect URI.
  • If you are not redirected to the Semrush login page, look for a login link in your client and open it by hand.
  • If you get a 400 error, clear your browser cookies and start the sign-in again.

Missing tools

If your agent does not show the discovery tools, get_report_schema and execute_report, check that sign-in finished, that your plan includes API access, and that your client's MCP configuration points at https://mcp.semrush.com/v2/mcp.

A community server you run yourself

mrkooblu/semrush-mcp is a community MCP server and CLI that you install with npm and run on your own machine. Its README says it is a personal project, not an official Semrush product. It calls the Semrush API with your key in a SEMRUSH_API_KEY environment variable, so it spends the same API units as the official server. It suits people who want a local stdio server or a command line; for most people the official hosted server is less to maintain.

Example prompts

Here are prompts you can try once Semrush MCP is connected.

Keyword research

"Find 20 keywords related to 'email marketing automation' in the US database with at least 500 monthly searches. Show volume, keyword difficulty, CPC and competitive density."

Rank check

"Check where example.com ranks in the US for 'project management software' and 'team collaboration tools'. Show the current position and the ranking URL."

"Show the top 20 referring domains linking to competitor.com, with their authority score and the most common anchor texts."

Domain overview

"Give me an overview of example.com in the US database: organic traffic, number of ranked keywords, top 10 keywords by traffic and top 5 organic competitors."

Keyword gap

"Compare example.com with competitor.com and list keywords they rank for that we do not, with at least 1,000 monthly searches and keyword difficulty under 40. Limit to 50 rows."

Run this in your agent

Connect Manifold to Claude, ChatGPT or Cursor, then paste this prompt.

Find keywords in our category with real search volume, check where we rank versus competitors, list their top referring domains, and show keyword gaps we can target.

If you do not pay for Semrush

Semrush MCP is the natural choice when you already pay for Semrush. If you do not, Manifold is a hosted MCP server that answers the same kinds of questions (keywords, rankings, backlinks, domain metrics) from DataForSEO's data, charges per call, and needs no API keys of your own. It also puts Search Console, Bing Webmaster Tools, AI answers, social, Reddit, ad libraries and leads in the same server. Semrush's MCP docs did not list AI answer data when we checked in October 2026.

The numbers will not match, because Semrush and DataForSEO run separate databases. Volumes, difficulty scores and traffic estimates are estimates either way, so pick one source and stick with it when you track trends.

For the side by side, read Semrush MCP alternative. To compare every SEO server, read the best SEO MCP servers. For Ahrefs' own server, its plans and units, see the Ahrefs MCP setup guide.

Questions people ask

Is Semrush MCP free?

No. Semrush MCP needs an eligible Semrush subscription, and every request spends API units from it. Semrush says there are no additional MCP usage fees on top of the units. Semrush One Starter, Pro+, SEO Classic Pro and Guru include 50,000 API units that refresh on your renewal date.

Which Semrush plans include MCP?

For SEO data: Semrush One Starter, Semrush One Pro+, SEO Classic Pro and SEO Classic Guru, each with 50,000 API units. Semrush One Advanced and SEO Classic Business work with an added API units package of 2, 5, 10 or 20 million units. Traffic and market data needs a Trends API Basic or Premium plan.

How many units does a Semrush MCP request use?

It depends on the report and how many lines it returns. In Semrush's own example, one line of the Domain Organic Search Keywords report costs 10 units for live data and 50 for historical data. Set a result count, a database and filters to keep usage down.

Which clients work with Semrush MCP?

Semrush documents setup for Claude, Claude Code, ChatGPT, Cursor, VS Code, Perplexity, Lovable and Antigravity. Claude, ChatGPT and Perplexity have an official Semrush app. Other clients connect to https://mcp.semrush.com/v2/mcp with OAuth, or with an API key if they cannot do OAuth. Semrush's docs say Gemini CLI support is discontinued, in favor of Antigravity.

Is there an open source Semrush MCP server?

Yes, a community one: mrkooblu/semrush-mcp on GitHub, an MCP server and CLI you install with npm and run locally with your Semrush API key. Its README says it is not an official Semrush product, and it spends the same API units as Semrush's own server.

How do I authenticate Semrush MCP with an API key?

Send your Semrush API key in the Authorization header as Authorization: Apikey YOUR_API_KEY. Semrush's docs use the Apikey prefix, not Bearer. OAuth is the default and needs no headers.

Does Semrush MCP include Search Console or Bing data?

No. Semrush MCP serves data from Semrush's own APIs. If you want Google Search Console and Bing Webmaster Tools data in the same server as SEO data, Manifold includes both at 0 credits per call.

Will Semrush MCP data match Manifold's?

No. Semrush MCP uses Semrush's own database, and Manifold's SEO tools use DataForSEO. Volumes, difficulty scores and traffic estimates will differ. Both are estimates, so pick one source and use it consistently when you track trends.

What happens if I run out of units?

Requests fail until your units refresh on your renewal date or you buy more on the Subscription info page. If you would rather pay per call, Manifold gives every workspace 250 free credits a month, with Pro from $20/mo.

Sources

Jesse Sibley

Jesse Sibley

Founder of Manifold. A growth engineer who has worked with London startups for eight years.

All SEO guides
  • 8 min read

    Discovered or crawled, currently not indexed: how to fix it

    Two Search Console statuses keep pages out of Google for different reasons. This guide shows how to tell them apart, rule out noindex and canonical problems, fix each one, and resubmit, by hand or with your agent.

  • 15 min read

    The best MCP servers for publishing to WordPress and other CMSs

    WordPress and CMS publishing MCP servers let your agent draft, edit and publish posts to WordPress.com, self-hosted WordPress, Webflow, Contentful, Sanity, Strapi and other CMSs. Here is what each covers, how it installs, and which to pick.

  • 11 min read

    ChatGPT for SEO: workflows and setup

    ChatGPT can do keyword research, SERP review, content briefs, technical audits and Search Console quick wins when connected to live search data. This guide shows how to add SEO data with an app, how to add a different server by URL, and four workflows with prompts you can copy.