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

Install

VibeSEO MCP is a remote, OAuth-secured server. Add this to your client's MCP config:

{
  "mcpServers": {
    "vibeseo": {
      "url": "https://mcp.vibeseo.dev/mcp"
    }
  }
}

One-click install:

      

CLI clients (Claude Code, Gemini CLI, Codex CLI) and manual snippets: see Supported clients.

Quick start

1. Create a free VibeSEO account at vibeseo.dev.
2. Open the VibeSEO MCP page and follow the setup link for your client.
3. Use the one-click install, copied CLI command, or manual JSON/TOML snippet.
4. Authorize with OAuth when your client opens the consent screen.
5. 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.

Troubleshooting

Common connection, OAuth, and tool-call errors: docs/troubleshooting.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.