en • es • de • ja • fr • pt • ru • it • nl • pl

VibeSEO MCP

Model Context Protocol server for SEO research, audits, and content workflow — secured by OAuth.

VibeSEO MCP brings live SEO work into your AI assistant. Connect Claude, ChatGPT, Cursor, VS Code, or a CLI client to VibeSEO. Then ask for keyword research, audits, backlinks, Search Console trends, and content workflow actions in natural language.

Server URL: https://mcp.vibeseo.dev/mcp
Transport: Streamable HTTP
Auth: OAuth 2.1 with PKCE, scope mcp:tools
Landing & setup: vibeseo.dev/mcp

Quick start

Create a free VibeSEO account at vibeseo.dev.
Open the VibeSEO MCP page and follow the setup link for your client.
Use the one-click install, copied CLI command, or manual JSON/TOML snippet.
Authorize with OAuth when your client opens the consent screen.
Ask your assistant for SEO work in natural language.

What you can do from chat

🔍 Keyword research — volumes, CPC, difficulty, intent, autocomplete ideas, question keywords, comparisons, and related terms.
🌐 Domain analysis — domain overview, top keywords, top pages, traffic history, and competitor suggestions.
🔗 Backlinks — profile, referring domains, anchor text, and history of any domain.
🛠️ Site audits — start audits, read crawl results, list issues, and prioritize fixes.
📈 GSC performance — connected Google Search Console summaries, top queries, top pages, trends, and query-level diagnostics.
🚀 Content workflow — list posts, refresh ideas, generate drafts, approve ready articles, schedule, and review.

Tool surface

The MCP server maps to the same SEO workflow inside VibeSEO. Categories:

| Category | What it covers | |---|---| | 📁 Projects | Create projects, update site information, manage competitors, keep account context current. | | 🔍 Keywords | Metrics, batches, suggestions, autocomplete, questions, comparisons, history, cleanup. | | 🌐 Domains | Overview, top keywords, top pages, traffic history, competitor ideas, lookup history. | | 🔗 Backlinks | Profile, referring domains, anchors, backlink history. | | 🧯 Audits | Start site audits, read summaries, list issues, inspect crawled pages. | | 📊 GSC | Connected properties, status, summaries, top queries, top pages, trends, query details. | | ✍️ Content | Ideas, drafts, approvals, scheduling, publishing targets, publications, keyword scoring. | | ⚔️ Competitive | Competitive overview and keyword gap analysis across domains. | | 📍 Locations | Countries, languages, locations, city lookups, location codes for market-specific research. |

The live tool set evolves. For the exact, up-to-date list, run tools/list against https://mcp.vibeseo.dev/mcp.

Supported clients

Setup paths for each:

Claude (web & desktop) — Connectors page or claude_desktop_config.json
ChatGPT — custom MCP connector with OAuth
Cursor — one-click install via deeplink, or ~/.cursor/mcp.json
VS Code — one-click install via deeplink, or .vscode/mcp.json
Claude Code (CLI) — claude mcp add --transport http vibeseo https://mcp.vibeseo.dev/mcp
Gemini CLI — gemini mcp add --transport http vibeseo https://mcp.vibeseo.dev/mcp
Codex CLI — codex mcp add vibeseo --url https://mcp.vibeseo.dev/mcp
Generic HTTP MCP client — point at the URL, let it complete OAuth discovery

Full per-client install instructions: docs/setup.md.

Example prompts

Keyword plan

"Find comparison keywords for my invoicing app that are realistic to rank for."

→ VibeSEO returns a prioritized topic list (commercial intent, lower difficulty, comparison angle).

Technical audit

"Audit my project and tell me what to fix before publishing more articles."

→ VibeSEO turns crawl data into next actions (missing canonicals, oversized images, internal-link gaps).

Publish queue

"Show ready posts, generate the next draft, and schedule the strongest one."

→ VibeSEO manages the content workflow (counts of Ready/Drafting, schedules the next approved article).

More: docs/examples.md.

Authorization & approval gate

Auth is OAuth 2.1 with PKCE. Your assistant gets a token scoped to mcp:tools, tied to your VibeSEO account. Tokens are revocable at any time from the VibeSEO MCP page under "Connected clients" — disconnecting a client revokes its access immediately.

MCP can help manage the workflow, but VibeSEO keeps the approval gate before content goes live. Drafts and scheduled posts still go through the standard review step inside VibeSEO.

OAuth flow details: docs/oauth.md.

Project links

Product: vibeseo.dev
VibeSEO MCP page: vibeseo.dev/mcp
MCP server: https://mcp.vibeseo.dev/mcp
OAuth issuer: https://api.vibeseo.dev
Issues: github.com/sultanlive/vibeseo-mcp/issues

License

MIT — see LICENSE.

Built by @sultanlive. VibeSEO is a hosted SEO platform; this repo is documentation for its public MCP server. Server source is not open.

MCP Servers