Agent setup

Connect The MCP Server

Use SerpGoblin's remote MCP endpoint to let coding agents inspect SEO work, prepare briefs, and update issue state without copying cards by hand.

Endpoint And Requirements

Use https://serpgoblin.com/api/mcp as the remote server URL in any MCP client.

Account

You need a SerpGoblin user that can access the projects you want agents to see.

Project Data

Connect Search Console, select a property, and run at least one analysis.

Client Support

Use an MCP client that supports remote HTTP servers and OAuth 2.0 login.

Codex

Codex stores MCP server entries in ~/.codex/config.toml and can register Streamable HTTP servers from the command line.

codex mcp add serp-goblin --url https://serpgoblin.com/api/mcp
codex mcp login serp-goblin --scopes full_access
codex mcp list

After the login opens in your browser, sign in to SerpGoblin and approve the client. Codex stores OAuth credentials for the server and refreshes access as needed.

#:schema https://developers.openai.com/codex/config-schema.json

[mcp_servers.serp_goblin]
url = "https://serpgoblin.com/api/mcp"
scopes = ["full_access"]
tool_timeout_sec = 70

Claude Code

Claude Code can add a remote HTTP MCP server, then use its in-session /mcp command to complete OAuth authentication.

claude mcp add --transport http serp-goblin https://serpgoblin.com/api/mcp
claude mcp list

Start Claude Code in the project where you want to work.
Run /mcp in Claude Code.
Select the SerpGoblin server and complete the browser login.
Ask Claude Code to list projects or inspect the highest priority issue.

Generic MCP JSON

For clients that accept JSON server configuration, use the remote HTTP shape below. Keep this private if it includes headers or environment variables.

{
  "mcpServers": {
    "serp-goblin": {
      "type": "http",
      "url": "https://serpgoblin.com/api/mcp"
    }
  }
}

Available Tools

list_projectsFind accessible projects.

get_project_boardRead Ready, Review, and Tracking lanes.

get_seo_issueOpen evidence, metrics, and notes for one issue.

start_analysisQueue a fresh Search Console analysis.

prepare_issue_briefMove an issue into Brief Builder.

discard_seo_issueRemove a recommendation from the active board.

mark_issue_resolvedMove shipped work into Tracking.