SERP Agent SEO
Full-cycle SEO automation for AI agents: technical audits, SEO articles, machine-readable pricing.
Open source Repository Open in the app JSON README (API)
About
Full-cycle SEO automation for AI agents: technical audits, SEO articles, machine-readable pricing.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- com.serp-agent
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.1
- Last push
- 2026-07-24T13:46:32Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 03:01:21
- Updated
- 2026-08-29 03:01:21
- Origin id
com.serp-agent/seo
README
# serpagent-mcp
[SERP Agent](https://serp-agent.com) — 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`](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).
## 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](https://serp-agent.com/docs/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:
```bash
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`).
## Install
### Claude Code
Prefer the direct HTTP transport:
```bash
claude mcp add --transport http serpagent https://serp-agent.com/mcp \
--header "Authorization: Bearer sk_..."
```
Or via this stdio bridge:
```bash
claude mcp add serpagent --env SERPAGENT_API_KEY=sk_... -- npx -y serpagent-mcp
```
### Cursor
`~/.cursor/mcp.json` (or project `.cursor/mcp.json`):
```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`:
```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