Back to Directory/Automation & Workflow

SERP Agent SEO

Full-cycle SEO automation for AI agents: technical audits, SEO articles, machine-readable pricing.

Automation & WorkflowJavaScriptv1.0.1

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":"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:

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

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y serpagent-mcp

Set up in your AI client

Merge 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.

json
{
  "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 reference

Package

serpagent-mcpnpm

Compatible MCP Clients

SERP 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.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.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.

Learn More