serpagent-mcp
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.
Tools
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.
Auth
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":"[email protected]"}'
Optional: SERPAGENT_MCP_URL overrides the server URL (default https://serp-agent.com/mcp).
Install
Claude Code
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
~/.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_..." } } }
VS Code (Copilot agent mode)
.vscode/mcp.json:
{
"servers": {
"serpagent": {
"type": "stdio",
"command": "npx",
"args": ["-y", "serpagent-mcp"],
"env": { "SERPAGENT_API_KEY": "sk_..." }
}
}
}
Links
- Docs: https://serp-agent.com/docs/mcp
- Agent quickstart (plain REST): https://serp-agent.com/docs/agents
- Machine-readable pricing: https://serp-agent.com/v1/plans
- OpenAPI: https://serp-agent.com/openapi.json
License
MIT