# ChatSEO MCP — Use ChatSEO inside Claude, Cursor & ChatGPT

> ChatSEO ships a remote MCP server so your AI assistant can read your Google Search Console data, run SEO audits, draft briefs, and manage sites — without leaving the chat.

- Endpoint: https://api.chatseo.app/mcp
- Transport: Streamable HTTP
- Issuer: https://api.chatseo.app/auth
- Resource metadata: https://api.chatseo.app/.well-known/oauth-protected-resource/mcp
- Plan required: Pro or higher (from €49/month)

## Quickstart

Pick your client. Copy the config. Sign in with OAuth on first use.

### Claude Desktop

~/.claude/claude_desktop_config.json:

```
{
  "mcpServers": {
    "chatseo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.chatseo.app/mcp"]
    }
  }
}
```

### Claude Code

CLI:

```
claude mcp add --transport http chatseo https://api.chatseo.app/mcp
```

### Cursor

.cursor/mcp.json:

```
{
  "mcpServers": {
    "chatseo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.chatseo.app/mcp"]
    }
  }
}
```

### VS Code (GitHub Copilot)

.vscode/mcp.json:

```
{
  "servers": {
    "chatseo": {
      "type": "http",
      "url": "https://api.chatseo.app/mcp"
    }
  }
}
```

### ChatGPT

Settings → Connectors → Add custom connector:

```
URL:   https://api.chatseo.app/mcp
Auth:  OAuth (automatic)
```

## Authentication

ChatSEO implements OAuth 2.1 with Protected Resource Metadata (RFC 9728). MCP clients bootstrap the flow automatically.

## Tools (40)

### Organizations

- `list_organizations` — List organizations the user belongs to
- `set_organization` — Set the active organization for the session
- `get_credits` — Remaining credits for the active organization

### Sites

- `get_gsc_sites` — List accessible Google Search Console properties
- `list_sites` — List sites in the active organization
- `get_site` — Get a site by ID
- `create_site` — Create a new site
- `update_site` — Update an existing site
- `delete_site` — Delete a site and its data

### Conversations

- `send_message` — Send a message to ChatSEO — the main entrypoint
- `list_conversations` — List conversations for the active organization
- `update_conversation` — Update conversation title or project
- `get_conversation_messages` — Fetch the full message history
- `share_conversation` — Create a public share link
- `get_share_status` — Return the current share status
- `revoke_share` — Revoke an existing share link

### Projects

- `list_projects` — List projects in the active organization
- `get_project` — Get a project by ID
- `create_project` — Create a project
- `update_project` — Update a project
- `delete_project` — Delete a project and its conversations

### Todos

- `list_todos` — List todos, filterable by project or site
- `get_todo` — Get a todo by ID
- `create_todo` — Create a todo
- `update_todo` — Update a todo
- `delete_todo` — Delete a todo and its subtasks

### Integrations

- `list_integrations` — List integrations (GSC, GA) for the organization
- `get_integration` — Get a specific integration
- `delete_integration` — Delete an integration
- `link_integration_to_site` — Bind an integration to a site
- `unlink_integration_from_site` — Unbind an integration from a site

### Shopify

- `shopify_list_blogs` — List all blogs from a connected Shopify store. Use this to discover available blogs before publishing.
- `shopify_search_articles` — Search Shopify articles by blog, handle, URL, publication status, tag, or text. Omit filters to list all articles.
- `shopify_resolve_article` — Get one full Shopify article. Provide exactly one mode: articleId, url, or blogHandle with handle.
- `shopify_publish_article` — Publish an article to a Shopify blog. Content must be in Markdown and will be converted to HTML automatically.
- `shopify_update_article` — Update an existing Shopify article. You can update the title, content, or both.
- `shopify_delete_article` — Delete an article from a Shopify blog.

### Artifacts

- `list_artifacts` — List artifacts attached to a conversation
- `get_artifact` — Get a single artifact by ID
- `update_artifact` — Update an artifact's title or content

## For AI agents

This page has machine-readable companions. If you're an agent, start here:

- https://chatseo.app/.well-known/mcp/server-card.json — Full server metadata (transport, auth, capabilities, tool catalog)
- https://chatseo.app/llms.txt — Curated index of authoritative ChatSEO documentation
- https://chatseo.app/llms-full.txt — Expanded reference with full tool catalog and auth flow

---

HTML version of this page: https://chatseo.app/mcp