English Français العربية

AgentSEO

Official registry Developer tools

Live SEO workflow tools for Claude Code, Codex, and AI agents.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http agentseo 'https://www.agentseo.dev/mcp' --header 'x-api-key: <Your AgentSEO server-side API key. Create one at https://www.agentseo.dev.>' --header 'x-project-id: <Optional project attribution for client, tenant, or workspace tracking.>' --header 'x-workflow-id: <Optional workflow attribution for scheduled jobs, agents, or automations.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agentseo": {
            "type": "http",
            "url": "https://www.agentseo.dev/mcp",
            "headers": {
                "x-api-key": "<Your AgentSEO server-side API key. Create one at https://www.agentseo.dev.>",
                "x-project-id": "<Optional project attribution for client, tenant, or workspace tracking.>",
                "x-workflow-id": "<Optional workflow attribution for scheduled jobs, agents, or automations.>"
            }
        }
    }
}
NPM package @agentseo/mcp-server
Claude Code 
claude mcp add agentseo -e 'AGENTSEO_API_KEY=<your agentseo_api_key>' -e 'AGENTSEO_API_URL=<AGENTSEO_API_URL>' -e 'AGENTSEO_PROJECT_ID=<AGENTSEO_PROJECT_ID>' -e 'AGENTSEO_WORKFLOW_ID=<AGENTSEO_WORKFLOW_ID>' -- npx -y @agentseo/mcp-server@0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agentseo": {
            "command": "npx",
            "args": [
                "-y",
                "@agentseo/mcp-server@0.1.3"
            ],
            "env": {
                "AGENTSEO_API_KEY": "<your agentseo_api_key>",
                "AGENTSEO_API_URL": "<AGENTSEO_API_URL>",
                "AGENTSEO_PROJECT_ID": "<AGENTSEO_PROJECT_ID>",
                "AGENTSEO_WORKFLOW_ID": "<AGENTSEO_WORKFLOW_ID>"
            }
        }
    }
}

Environment variables

  • AGENTSEO_API_KEY required secret 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.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. AgentSEO Clients
  2. Quick Start
  3. Development
  4. Security
  5. License

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:

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:

pip install agentseo-sdk
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:

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

Development

Build the JavaScript SDK:

cd packages/js-sdk
npm install
npm run build

Build the MCP server:

cd packages/mcp-server
npm install
npm run build

Install the Python SDK locally:

cd packages/python-sdk
python -m pip install -e .

Security

Do not commit API keys, .env files, customer payloads, or provider credentials. See SECURITY.md.

License

MIT. See package-level LICENSE files.

Frequently asked questions

What is AgentSEO?

Live SEO workflow tools for Claude Code, Codex, and AI agents.

How do I install AgentSEO?

It runs as a remote server. In Claude Code: claude mcp add --transport http agentseo 'https://www.agentseo.dev/mcp' --header 'x-api-key: <Your AgentSEO server-side API key. Create one at https://www.agentseo.dev.>' --header 'x-project-id: <Optional project attribution for client, tenant, or workspace tracking.>' --header 'x-workflow-id: <Optional workflow attribution for scheduled jobs, agents, or automations.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does AgentSEO need an API key?

Yes. It expects AGENTSEO_API_KEY, x-api-key, x-project-id, x-workflow-id, which you set in its configuration.

Is AgentSEO open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains AgentSEO?

It is published by AgentSEO-dev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.