Full-cycle SEO automation for AI agents: technical audits, SEO articles, machine-readable pricing.
SERP Agent — full-cycle SEO automation for AI agents — as an MCP server.
This package is a thin stdio bridge for MCP clients that cannot speak Streamable HTTP directly. It proxies stdio ⇄ HTTP to the remote server at https://serp-agent.com/mcp (via mcp-remote). If your client supports remote HTTP servers, connect directly instead — see serp-agent.com/docs/mcp.
create_project, list_projects, get_project, run_technical_audit, get_audit_report, generate_article, get_article, get_account_status, list_plans — a thin layer over the SERP Agent REST API. Long-running jobs (audits, articles) return a job id immediately; poll the matching get_* tool.
Set SERPAGENT_API_KEY to your sk_... key. No key yet? Free sandbox key in one call, no CAPTCHA:
curl -X POST https://serp-agent.com/v1/accounts \
-H "content-type: application/json" \
-d '{"email":"you@example.com"}'
Optional: SERPAGENT_MCP_URL overrides the server URL (default https://serp-agent.com/mcp).
Prefer the direct HTTP transport:
claude mcp add --transport http serpagent https://serp-agent.com/mcp \
--header "Authorization: Bearer sk_..."
Or via this stdio bridge:
claude mcp add serpagent --env SERPAGENT_API_KEY=sk_... -- npx -y serpagent-mcp
~/.cursor/mcp.json (or project .cursor/mcp.json):
{
"mcpServers": {
"serpagent": {
"command": "npx",
"args": ["-y", "serpagent-mcp"],
"env": { "SERPAGENT_API_KEY": "sk_..." }
}
}
}
Direct HTTP alternative: { "serpagent": { "url": "https://serp-agent.com/mcp", "headers": { "Authorization": "Bearer sk_..." } } }
.vscode/mcp.json:
{
"servers": {
"serpagent": {
"type": "stdio",
"command": "npx",
"args": ["-y", "serpagent-mcp"],
"env": { "SERPAGENT_API_KEY": "sk_..." }
}
}
}
MIT
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y serpagent-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"com-serp-agent-seo": {
"command": "npx",
"args": [
"-y",
"serpagent-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referenceSERP Agent SEO works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.