@agentseo/mcp-server

@agentseo/mcp-server

The official Model Context Protocol (MCP) server for AgentSEO. Exposes SEO tools to Claude Desktop and other MCP clients.

Installation

This package is part of the AgentSEO monorepo.

• Build the server:

  npm run build
  

• Locate the build artifact: ./dist/index.js

Configuration

The server runs over stdio and requires the following environment variables:

• AGENTSEO_API_KEY: Your workspace API key.
• AGENTSEO_API_URL: (Optional) Defaults to http://localhost:3000/api/v1.

Claude Desktop Example

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "agentseo": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "AGENTSEO_API_KEY": "sk_live_..."
      }
    }
  }
}

Available Tools

agentseo_search

Perform a Google search.

• query (string): Search term.
• limit (number): Max results (default 10).
• include_domains (string[]): Domain whitelist.

agentseo_extract

Extract content from a URL.

• url (string): Target URL.
• include_images (boolean): Keep image markdown.

agentseo_analyze_serp

Detailed SERP analysis.

• keyword (string): Target keyword.
• location (string): "United States", "United Kingdom", etc.
• device (string): "desktop" or "mobile".