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.

How do I connect Semrush to Claude?
Semrush's official MCP server connects AI agents such as Claude, ChatGPT and Cursor to Semrush's SEO data: keywords, domain analytics, backlinks, competitors, position tracking and site audits. Semrush hosts it at https://mcp.semrush.com/v2/mcp, and it signs you in with OAuth or a Semrush API key.
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
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:
- Open Claude and go to Customize → Connect your apps
- Search for Semrush, select it and click Connect
- Review the permission screen and click Approve
- 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:
claude mcp add semrush https://mcp.semrush.com/v2/mcp -t httpHow to connect Semrush MCP to ChatGPT
Semrush is also an official ChatGPT app:
- Go to Settings → Apps
- Find and select Semrush, then click Connect
- Click Continue, review the permission screen and click Approve
- 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:
{
"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:
Authorization: Apikey YOUR_API_KEYNote 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:
- Be specific. Ask for "the top 50 keywords in the US database" rather than "all keywords".
- Always set a result count, a database and filters.
- Avoid historical data unless you need it.
- Keep related questions in one chat so the agent can reuse what it already fetched.
- 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
400error, 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."
Competitor backlinks
"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 SEO subscription or API key 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.


