Semrush helps marketers research keywords, analyze competitor websites, audit SEO performance, track search rankings, investigate backlinks, and monitor brand visibility across traditional search engines and AI-powered search platforms.
Hermes is Nous Research's command-line agent. MCP servers are declared in its YAML config and reloaded without a restart.
This guide connects Semrush MCP to Hermes through MewCP, so Hermes can use Semrush MCP's 14 tools, like audience_research, backlinks_research and competitors_research, without your Semrush MCP credentials ever reaching the app.
Your Semrush MCP API key is stored encrypted and injected only at call time. Your agent never holds it, so it can never leak it, log it or paste it into a prompt.
More apps
Manage your Google Business Profile, business information and customer engagement. Update listings, publish content, monitor reviews and maintain your local presence across Google services.
Full Google Search Console control for search analytics, sitemaps, sites, and URL inspection, directly from your AI workflows. This MCP server exposes the Google Search Console API for querying search traffic data, managing sitemaps and site properties, and inspecting the indexing status of any URL. It is built for SEO teams monitoring search performance, developers automating sitemap and property management, and analysts pulling search traffic data into reporting pipelines.
Brevo's marketing and CRM platform — manage contacts, lists and segments, send transactional and campaign email, run SMS and WhatsApp campaigns, and track deals and companies
Meta Ads connects AI agents to Facebook and Instagram advertising accounts to analyze campaign performance, create and edit campaigns, ad sets and creatives, manage custom audiences and product catalogs, inspect conversion tracking signals, run A/B tests, and investigate advertising issues.
Other clients
Semrush MCP works the same way in every client below. Pick yours for its own guide.
Free to start.
Scope access to the exact Semrush MCP tools and accounts you allow, work and personal side by side. Anything outside that scope is refused at call time, even when the model asks for it.
Each call is logged: what ran, on which account, and whether it worked. Failures come back structured, so the agent knows whether to retry instead of guessing.
Every app sits behind one secure MCP URL, and there is no server for you to deploy or keep running. Add an integration in the dashboard and it is live on the next call, with no config to change and no new credentials to wire up. Tools load only when a task needs them, so your agent stays fast and focused however many apps you connect.
Edit config.yaml in your Hermes config directory (~/.hermes).
Put this under the top-level "mcp_servers:" key.
Run /reload-mcp in Hermes, or start a fresh session. Sign in when the browser window opens.
Start a new chat and ask: "List the tools you can use from MewCP." You should see your connected apps.
Audience Analytics: visitor profile of a domain — demographics (age, gender, income, education, household size, occupation), audience interests, visitor geography by country, audience overlap between domains, purchase conversion, and top domains by industry category. Returns available reports. NEXT: get_report_schema then execute_report.
Backlink Analytics: for a single domain's link profile — backlinks, referring domains and IPs, anchor texts, geographic and TLD distribution, Authority Score breakdown, domain and referring-domain categories, and historical trends. Analyzes one domain at a time. Not suitable for comparing or cross-referencing backlink data across multiple domains. Returns available reports. NEXT: get_report_schema then execute_report.
Competitive Research: find who competes with a domain in organic search, paid search, and Google Shopping (PLA); compare keyword overlap and backlink profiles between multiple domains; analyze market rankings and backlink competitors. Returns available reports. NEXT: get_report_schema then execute_report.
Domain Overview: get high-level counters for a domain, subdomain, subfolder, or URL — Semrush Rank, keyword/traffic/cost totals, PLA, SERP Features. NEXT: get_report_schema then execute_report.
Execute any Semrush report. Requires params from get_report_schema.
Get a report's parameters. Returns the schema execute_report needs when those parameters are not already known.
Keyword Analytics: look up any keyword — search volume, CPC, competition, keyword difficulty, SERP results (organic and paid), related keywords, broad match variations, phrase questions, and ads history. Returns available reports. NEXT: get_report_schema then execute_report.
Organic Search Analytics: list the actual keywords and pages a domain, subdomain, or URL ranks for in organic search (position, volume, traffic). NEXT: get_report_schema then execute_report.
Paid Search Analytics: keywords that trigger a domain's paid search (Google Ads) results, ad positions, CPCs, traffic estimates, unique ad copies with titles and descriptions, and historical PPC trends. Requires a domain as input — not for keyword-to-domain lookups. Returns available reports. NEXT: get_report_schema then execute_report.
Position Tracking: ongoing rank monitoring within pre-configured project campaigns — track how a domain ranks for targeted keywords over time, daily position changes in organic and paid search, visibility trends, and landing page performance, by location and device. Returns available reports. NEXT: get_report_schema then execute_report.
Project Management: list and inspect your Semrush projects (campaigns) — each project's ID, name, and tracked domain, plus which tools are enabled. Use first to obtain the project ID that position_tracking and site_audit require as input. Returns available reports. NEXT: get_report_schema then execute_report.
Shopping Analytics: keywords that trigger a domain's Google Shopping (PLA) ads, ad positions, traffic estimates, and unique product listings with titles and prices. Returns available reports. NEXT: get_report_schema then execute_report.
Site Audit: technical SEO health analysis within pre-configured project campaigns — crawl a website to find errors, warnings, and notices, site health score, page-level issue details with fix recommendations, and historical audit snapshots to track progress. Returns available reports. NEXT: get_report_schema then execute_report.
Traffic Overview: website traffic volume and engagement — total visits, unique visitors, pages per visit, bounce rate, visit duration, daily/weekly trends, acquisition channels (direct, referral, search, social, paid), traffic destinations, top pages, subdomain and subfolder breakdown. Returns available reports. NEXT: get_report_schema then execute_report.
