MCP Platform
Configuration
Add your API key and register the MCP server with your client.
The MCP server runs on two environment variables. You add them to your client's configuration file, and the server reads them to connect to the Semust API.
Environment variables
Environment
SEMUST_API_KEYstringrequiredYour Semust account API key, from Settings → API Key.
SEMUST_BASE_URLstringdefault: https://api.semust.com/v1/mcpAPI base URL. You should not need to change this.
Basic configuration
{
"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"
}
}
}
}Path and Python
Replace the path in args with the real location of semust_mcp.py on your machine.
On Windows use double backslashes: C:\\Users\\you\\semust-mcp\\semust_mcp.py. If
python is not recognised, use the full path to your Python executable.
Auto-approving tools
Every Semust tool is read-only. To avoid approving each call, add tool names to
the alwaysAllow list:
"alwaysAllow": [
"list_projects",
"get_keywords", "get_pages", "get_performance",
"rank_get_keywords", "rank_get_overview",
"ga_get_overview", "gads_get_campaigns"
]Remove the field entirely if you would rather approve every call individually.
Security
Your API key never leaves your machine. Claude only sees the SEO data that comes back, never your credentials. See Security for detail.