agentseo-mcp (dev.agentseo.www/agentseo-mcp)

The agentseo-mcp server provides live SEO workflow tools intended for use with Claude Code, Codex, and AI agents. Its purpose is to support SEO-related workflows in these environments, based on the server’s description: “Live SEO workflow tools for Claude Code, Codex, and AI agents.”

🛠️ Key Features

Live SEO workflow tools
Designed for Claude Code
Designed for Codex
Designed for AI agents

🚀 Use Cases

Running SEO workflows from within Claude Code
Running SEO workflows from within Codex
Integrating SEO workflow tooling into AI agents

⚡ Developer Benefits

Focused tooling for SEO workflows
Compatibility with multiple agent/code environments: Claude Code, Codex, and AI agents

⚠️ Limitations

Available details only specify live SEO workflow tooling and target environments; no additional capabilities or constraints are provided.

AgentSEO Clients

Official open-source clients for AgentSEO, the SEO intelligence API for AI agents and developer workflows.

This repository contains the integration layer only:

packages/js-sdk - JavaScript/TypeScript SDK

packages/python-sdk - Python SDK

packages/mcp-server - Model Context Protocol server

The hosted AgentSEO API, worker system, provider orchestration, billing, and transformation logic are not part of this repository.

Quick Start

Use the JavaScript SDK:

bash

npm install @agentseo/sdk

import { AgentSEO } from "@agentseo/sdk";

const client = new AgentSEO({
  apiKey: process.env.AGENTSEO_API_KEY!,
});

const result = await client.search(
  { query: "seo api", location: "United States", limit: 5 },
  { sync: true },
);

console.log(result);

Use the Python SDK:

bash

pip install agentseo-sdk

python

from agentseo_sdk import AgentSEOClient

client = AgentSEOClient(api_key="sk_live_...")
result = client.search(query="seo api", sync=True)
print(result)

Use the MCP server:

bash

export AGENTSEO_API_KEY="sk_live_your_key"
npx -y @agentseo/mcp-server

Install

Configuration

Environment variables

AGENTSEO_API_KEYrequiredsecret

Your AgentSEO server-side API key.

AGENTSEO_API_URL

Optional API base URL. Defaults to https://www.agentseo.dev/api/v1.

AGENTSEO_PROJECT_ID

Optional project attribution for usage and job tracking.

AGENTSEO_WORKFLOW_ID

Optional workflow attribution for usage and job tracking.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentseo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentseo/mcp-server@0.1.3"
      ],
      "env": {
        "AGENTSEO_API_KEY": "<YOUR_AGENTSEO_API_KEY>",
        "AGENTSEO_API_URL": "<YOUR_AGENTSEO_API_URL>",
        "AGENTSEO_PROJECT_ID": "<YOUR_AGENTSEO_PROJECT_ID>",
        "AGENTSEO_WORKFLOW_ID": "<YOUR_AGENTSEO_WORKFLOW_ID>"
      }
    }
  }
}

AgentSEO

agentseo-mcp (dev.agentseo.www/agentseo-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

AgentSEO Clients

Quick Start

Development

Security

License

Install

Configuration