How to connect Semrush MCP to Claude Desktop
Add this block to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Cursor and Codex use a similar schema.
{
"mcpServers": {
"semrush": {
"command": "npx",
"args": ["-y", "<server-package-name>"],
"env": {
"SEMRUSH_API_KEY": "your-api-key-here"
}
}
}
}
// Server source: https://www.semrush.com/mcp/
// Check the server's README for the exact "command" and required env vars.Some MCP servers require an API key. Check the source page for setup: semrush.com/mcp.
Does Semrush MCP cost extra?
Semrush ships an official MCP server that uses your existing subscription credentials.
- No separate MCP licence to buy. You pay for your Semrush plan, the MCP server queries that account.
- Whether it's gated to a specific tier wasn't extracted automatically — verify the access requirements on the MCP page or pricing docs.
Semrush subscription pricing
| Plan | Monthly | Annual / mo |
|---|---|---|
| Pro | $139 | $117.33 |
| Guru | $249 | $208.33 |
| Business | $499 | $416.66 |
Source: semrush.com/pricing. Scraped 2026-05-19.
Semrush also publishes a REST API
Semrush publishes an API, but per-tier gating wasn't extracted automatically.
What you can do with Semrush from an AI agent
Three shapes of agent workflow. Pick the row that matches how you actually use Claude / Cursor / Codex day to day.
Skip the dashboard, ask Claude
- "What keywords moved this week?" answered in seconds
- Quick one-off questions without leaving the editor
- Pipe Semrush data into your personal notes / docs without writing a script
Run client analysis at agent speed
- Hand the MCP server to your team — every consultant can ask Claude about any client's Semrush account
- Multi-account workflows without context-switching the Semrush UI
- Reports you'd normally spend hours on, done before standup
Production agent workflows
- Embed in your internal Codex / Cursor agents that triage Semrush data daily
- Combine with other MCP servers in a multi-step agent chain
- Constrain agents to read-only roles to keep production Semrush safe
Limits and gotchas
- Official MCP server — published by Semrush themselves, so it should track product changes.
- Fallback: the REST API works for any flow the MCP server doesn't cover.
- Rate limits: MCP calls count against your underlying Semrush API quota. Burst usage from a curious agent can drain a daily allowance fast.
Agent-readiness verdict
Limited agent integration despite MCP availability. Semrush offers an official MCP server, but lacks documented public APIs, SDKs, and structured output support that agents need for reliable data retrieval. The MCP alone won't unlock its full SEO toolkit for Claude or Cursor workflows.
Scored 2026-05-19 by Joonas (TMB).
Semrush MCP & API FAQ
Is the Semrush MCP server official?+
Can I use the Semrush MCP with Cursor or Codex?+
Sources
- Semrush official site: https://www.semrush.com/
- MCP server page: https://www.semrush.com/mcp/
- Pricing source: https://www.semrush.com/pricing/ (scraped 2026-05-19)
Data verified by Joonas on the dates shown. MCP server status auto-rechecked weekly.

