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:
<a href="https://cursor.com/en/install-mcp?name=vibeseo&config=eyJuYW1lIjoidmliZXNlbyIsInR5cGUiOiJodHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AudmliZXNlby5kZXYvbWNwIn0="><img src="https://vibeseo.dev/icons/cursor.svg" width="36" alt="Cursor"></a> <a href="https://insiders.vscode.dev/redirect/mcp/install?name=vibeseo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.vibeseo.dev%2Fmcp%22%7D"><img src="https://vibeseo.dev/icons/vscode.svg" width="36" alt="VS Code"></a> <a href="https://claude.ai/settings/connectors"><img src="https://vibeseo.dev/icons/claude-desktop.svg" width="36" alt="Claude"></a> <a href="https://chatgpt.com/settings/connectors"><img src="https://vibeseo.dev/icons/chatgpt-icon.svg" width="36" alt="ChatGPT"></a>
CLI clients (Claude Code, Gemini CLI, Codex CLI) and manual snippets: see Supported clients.
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.
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.