{
  "markdown": "# serpagent-mcp\n\n[SERP Agent](https://serp-agent.com) — full-cycle SEO automation for AI agents — as an MCP server.\n\nThis 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`](https://www.npmjs.com/package/mcp-remote)). **If your client supports remote HTTP servers, connect directly instead** — see [serp-agent.com/docs/mcp](https://serp-agent.com/docs/mcp).\n\n## Tools\n\n`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](https://serp-agent.com/docs/api). Long-running jobs (audits, articles) return a job id immediately; poll the matching `get_*` tool.\n\n## Auth\n\nSet `SERPAGENT_API_KEY` to your `sk_...` key. No key yet? Free sandbox key in one call, no CAPTCHA:\n\n```bash\ncurl -X POST https://serp-agent.com/v1/accounts \\\n  -H \"content-type: application/json\" \\\n  -d '{\"email\":\"you@example.com\"}'\n```\n\nOptional: `SERPAGENT_MCP_URL` overrides the server URL (default `https://serp-agent.com/mcp`).\n\n## Install\n\n### Claude Code\n\nPrefer the direct HTTP transport:\n\n```bash\nclaude mcp add --transport http serpagent https://serp-agent.com/mcp \\\n  --header \"Authorization: Bearer sk_...\"\n```\n\nOr via this stdio bridge:\n\n```bash\nclaude mcp add serpagent --env SERPAGENT_API_KEY=sk_... -- npx -y serpagent-mcp\n```\n\n### Cursor\n\n`~/.cursor/mcp.json` (or project `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"serpagent\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"serpagent-mcp\"],\n      \"env\": { \"SERPAGENT_API_KEY\": \"sk_...\" }\n    }\n  }\n}\n```\n\nDirect HTTP alternative: `{ \"serpagent\": { \"url\": \"https://serp-agent.com/mcp\", \"headers\": { \"Authorization\": \"Bearer sk_...\" } } }`\n\n### VS Code (Copilot agent mode)\n\n`.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"serpagent\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"serpagent-mcp\"],\n      \"env\": { \"SERPAGENT_API_KEY\": \"sk_...\" }\n    }\n  }\n}\n```\n\n## Links\n\n- Docs: https://serp-agent.com/docs/mcp\n- Agent quickstart (plain REST): https://serp-agent.com/docs/agents\n- Machine-readable pricing: https://serp-agent.com/v1/plans\n- OpenAPI: https://serp-agent.com/openapi.json\n\n## License\n\nMIT\n",
  "bytes": 2367,
  "sha": "8a47aedb07047ec83f1f099585bfc945ba41e95b86a0061fc5000176eaed7a1f",
  "repo_slug": "lonchdigital/serpagent-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_serp_agent_seo_ecee1eea/readme"
}