Semust MCP Server

Semust MCP Server

Ask Claude about your SEO data in plain language. This MCP server connects Claude Desktop (and Cursor) to your Semust account — keywords, pages, traffic trends, SEO reports, and more.

"Show me my top keywords for the last month"

"Which pages are losing traffic?"

"Find quick win keywords close to page 1"

How It Works

You ask Claude a question
        |
Claude Desktop (on your machine)
        |
   MCP Server (on your machine) ---- Your API key stays here, never sent to Claude
        |
   Semust API (semust.com)
        |
   Your Google Search Console data
        |
   Results sent back to Claude
        |
Claude answers with SEO insights

Your API key never leaves your machine. Claude only sees the SEO data, not your credentials.

What You Can Ask

Once set up, just talk to Claude naturally:

Traffic & Performance

• "How is my site performing this month?"
• "Show me daily traffic for the last 30 days"

Keywords

• "What are my top 20 keywords?"
• "Which keywords are on page 2? Those are my quick wins"
• "Find long-tail keyword opportunities"

Content Analysis

• "Which pages are losing traffic? I need to refresh them"
• "Show me my worst performing content"
• "Do I have keyword cannibalization issues?"

Reports

• "Generate a monthly SEO report for May 2026"
• "Which keywords gained or lost traffic this month?"
• "Find low CTR keywords I should optimize"

Content Ideas

• "What questions are people asking that lead to my site?"
• "Show me long-tail keywords with 4+ words"

Quick Start

Step 1: Get Your API Key

Log in to Semust > Settings > API Key > Copy.

Make sure you have at least one project with Google Search Console connected.

Step 2: Download & Install

Option A: Download ZIP (easiest)

Download ZIP > Extract to a folder you'll remember.

Option B: Git Clone

git clone https://github.com/semust/semust-mcp.git

Then install dependencies:

cd semust-mcp
pip install -r requirements.txt

Step 3: Configure Claude Desktop

Find your Claude Desktop config file:

%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\

%APPDATA%\Claude\

~/Library/Application Support/Claude/claude_desktop_config.json

Add mcpServers to the file. If the file already has content, merge this into the existing JSON:

{
  "mcpServers": {
    "semust": {
      "command": "python",
      "args": ["C:\\full\\path\\to\\semust-mcp\\semust_mcp.py"],
      "env": {
        "SEMUST_API_KEY": "your-api-key-here",
        "SEMUST_BASE_URL": "https://api.semust.com/v1/mcp"
      }
    }
  }
}

Important: Replace the path with the actual location of semust_mcp.py on your machine.

Windows: Use double backslashes: C:\\Users\\you\\semust-mcp\\semust_mcp.py

If python doesn't work: Use the full Python path instead, e.g.: C:\\Users\\you\\AppData\\Local\\Programs\\Python\\Python312\\python.exe

Quit Claude Desktop completely (right-click system tray icon > Quit) and reopen it.

Step 4: Verify

In a new Claude chat, look for the tools icon (hammer/wrench) near the text input. Click it — you should see "semust-mcp" with 13 tools.

Type: "Show me my projects" — Claude should list your Semust projects.

Security

• The MCP server runs locally on your computer — it is not a cloud service
• Your Semust API key is used only for direct requests from your machine to api.semust.com
• Claude sees the SEO data responses but never your API key or authentication credentials
• The .env file is in .gitignore — it won't be accidentally committed to git
• The server refuses to start if SEMUST_BASE_URL is http:// (non-localhost) — your key is never sent in plaintext
• Protect your Claude Desktop config file — anyone with read access to it can read your API key
• SEO data passed to Claude is treated as user-trusted content; if your Search Console contains spam queries with embedded instructions, the model may act on them — this is inherent to all MCP tools that surface third-party data

Available Tools (13)

Data

SEO Reports

Cursor Setup

Add the same MCP server in Cursor: Settings > MCP Servers > Add Server (stdio type).

Use the same command, args, and env values from the Claude Desktop config above.

Troubleshooting

Requirements

• Python 3.10+
• Claude Desktop or Cursor
• A Semust account with an active subscription
• Google Search Console connected to at least one project

License

MIT — see LICENSE