Menu

AI

Semrush MCP Server: Tools, Setup and Security

Semrush's hosted MCP server: which APIs it covers, eligible plans and API units, OAuth 2.1 setup for Claude Code, Cursor and VS Code, and risks.

By: Irina ShvayaOctober 28, 2026

Semrush MCP Server: Tools, Setup and Security

This profile is part of our MCP server directory, within The MCP Guide. Profiles are checked against each vendor's own documentation. Need a server built? See MCP development.

The Semrush MCP server lets an AI app pull Semrush SEO, traffic and project data into a chat. You can ask about keywords, competitors or domain traffic without exporting reports. Semrush hosts the server and documents it on its developer site.

Checked against: Semrush MCP documentation on 28 October 2026. eSEOspace did not install or test this server.

For how this fits day-to-day search work, see our guide to MCP for SEO.

Key Takeaways

  • Semrush hosts the server at https://mcp.semrush.com/v2/mcp over Streamable HTTP.
  • It covers all SEO API endpoints, all Trends API endpoints (by subscription level) and read-only Projects API methods.
  • Sign-in is OAuth 2.1 by default, with an API key header as a fallback.
  • Every request uses API units from your plan, so heavy AI use has a real cost.
  • Plan names differ between Semrush's docs and its pricing page, so confirm eligibility first.

At a glance

ItemDetail
PublisherSemrush
Official?Yes
HostingRemote URL: https://mcp.semrush.com/v2/mcp
TransportStreamable HTTP only
Sign-inOAuth 2.1; API key header fallback
Read or writeRead (Projects API access is read-only)
PriceIncluded with eligible plans; uses API units
Source codeClosed
StatusNot stated (the docs page carries a "new" badge)

What it can do

Semrush's docs describe coverage by API rather than by tool name:

  • SEO API: all endpoints.
  • Trends API: all endpoints, depending on your Trends API subscription level.
  • Projects API (v3): read-only methods. The docs say you "cannot create projects, change settings, or take other actions."

The docs page does not list individual tool names. Each request consumes units based on report type and data volume. Semrush points to its API reference for per-report estimates.

How to connect it

For Claude Code, Semrush's docs give this command:

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

Then run /mcp, select the Semrush server and choose Authenticate.

For Cursor, add this to your MCP settings:

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

For VS Code, create .vscode/mcp.json:

{"servers": {"semrush": {"url": "https://mcp.semrush.com/v2/mcp", "type": "http"}}}

Semrush also documents connections from the Claude app, ChatGPT, Microsoft Copilot (through the Microsoft Marketplace, if your organization allows third-party connectors), Perplexity, Lovable and Antigravity. The docs say Gemini CLI support is discontinued.

If your agent cannot do OAuth, send your key in a header: Authorization: Apikey YOUR_API_KEY.

Pricing and eligible plans

The docs list these plans as eligible for the Standard API with 50,000 API units: Semrush One Starter, Semrush One Pro+, SEO Classic Pro and SEO Classic Guru. SEO Classic Business and Semrush One Advanced qualify with an API units package. Any Basic or Premium Trends API plan includes MCP access.

Semrush's pricing page lists "MCP access" on the Starter plan at $199 a month, or $165.17 a month billed annually. The docs say Claude, ChatGPT and Perplexity add no fees of their own; the cost is your Semrush units.

Security notes

  • Read-only project data. The AI can read your Semrush projects but not change them.
  • Prefer OAuth over the API key. OAuth sends you through the Semrush login page. An API key pasted into a config file can leak.
  • Watch unit spend. An agent that loops over many domains can burn units fast. Check usage after your first sessions.
  • Third-party data in your chat. SEO results include text from other websites. Treat it as untrusted input, as our guide to MCP prompt injection explains.

See the MCP security hub for a fuller checklist.

Alternatives

Next step

Compare the SEO data servers side by side in our list of MCP servers for marketing. If you want help building Semrush data into your reporting, see Claude Code consulting.

Frequently asked questions

Which Semrush plans include MCP?

The docs name Semrush One Starter, Semrush One Pro+, SEO Classic Pro and SEO Classic Guru for the Standard API. Two higher plans qualify with an API units package. Any Basic or Premium Trends API plan also includes MCP access.

Can the Semrush MCP server change my projects?

No. Semrush says Projects API access is read-only. You can retrieve project data but cannot create projects or change settings.

Does it cost extra to use Semrush in Claude or ChatGPT?

Semrush says those apps add no fees. Each request still uses Semrush API units from your plan, based on report type and data volume.

What if my AI tool does not support OAuth?

Semrush documents an API key fallback. Pass it as Authorization: Apikey YOUR_API_KEY. Store the key securely and rotate it if it is exposed.

You Might Also like to Read

Get a FREE Website Audit

Enter your website and get a 20–30 page SEO, GEO, AEO & CRO audit within 24 hours. Completely free.

Don't have a site yet? Get in touch →

Ready to speak with a marketing expert?
Give us a call! (916) 866-7893

Websites Launched
1407
Websites Launched
Marketing Experts
29
Marketing Experts
Hours of Dedicated Work
204533
Hours of Dedicated Work
Irina S.Benjamin G.Jeanette M.David G.