VibeSEO

VibeSEO helps website owners with keyword and competitor research, Google Search Console monitoring, technical site audits, and AI-assisted blog idea generation, drafting, approval, and scheduling — all scoped to the user's projects inside VibeSEO.

GitHub

Documentation

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

Create a VibeSEO account at vibeseo.dev and start a trial — $0 today, card required (see Plans & access).
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.
🛠️ 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.
🔗 Backlinks (Pro) — profile, referring domains, anchor text, and history of any domain.
🚀 Content workflow (Pro) — 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	List projects, read project and site information, list and replace tracked competitors.
🔍 Keywords	Metrics, autocomplete, related, question, preposition and comparison keywords, lookup history.
🌐 Domains	Overview, top keywords, top pages, traffic history, competitor ideas, lookup history.
🧯 Audits	Start site audits, read summaries, list issues, inspect crawled pages.
📊 GSC	Connection status, summaries, top queries, top pages, trends, query details.
⚔️ Competitive	Competitive overview and keyword gap analysis across domains.
📍 Locations	Countries, languages, locations, city lookups, location codes for market-specific research.
🔗 Backlinks (Pro)	Profile, referring domains, anchors, backlink history.
✍️ Content (Pro)	Ideas, drafts, approvals, scheduling, content calendar, publications, keyword scoring.

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

Plans & access

The tools call paid data providers and AI models on your behalf, so they need a live VibeSEO subscription — a trial or a paid plan. There is no anonymous or free-forever tier.

	Trial	SEO Researcher	Pro
Price	$0 today, card required	$9/mo	$39/mo
Keywords, domains, audits, GSC, competitive, locations	✅	✅	✅
Backlink data	—	—	✅
AI content workflow (ideas, drafts, publishing)	—	—	✅
Monthly credits	40	400	1500

The trial is card-required, starts at $0, and can be cancelled at any time; it runs at research-level limits and converts to the plan you picked when it ends. Credits meter the calls that cost money (keyword lookups, audits, AI generation) — see vibeseo.dev/pricing for the current plans.

You never have to leave the chat to pay. If you call a tool without an active subscription, out of credits, or on a plan that doesn't include it, the tool result comes back with a one-click checkout or top-up link for your account.

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.

Cursor plugin

This repository is also a Cursor plugin. It contributes one MCP server (vibeseo) and no rules, skills, agents, or hooks.

.cursor-plugin/plugin.json   ← plugin manifest
mcp.json                     ← the MCP server it contributes
assets/logo.svg              ← plugin logo

mcp.json points Cursor at the hosted server:

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

There is nothing to configure. No API key or environment variable is required: the server advertises OAuth 2.1 metadata, and Cursor registers itself dynamically and opens the consent screen on first use. Authorizing needs a VibeSEO account on a trial or paid plan — see Plans & access.

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.