VibeSEO

en • [es](README.es.md) • [de](README.de.md) • [ja](README.ja.md) • [fr](README.fr.md) • [pt](README.pt.md) • [ru](README.ru.md) • [it](README.it.md) • [nl](README.nl.md) • [pl](README.pl.md)

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](#supported-clients).

Quick start

1. Create a VibeSEO account at vibeseo.dev and start a trial — $0 today, card required (see [Plans & access](#plans--access)).
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.
• 🛠️ 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:

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.

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 — extension: gemini extensions install https://github.com/sultanlive/vibeseo-mcp, or server only: 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](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](#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](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](docs/oauth.md).

Troubleshooting

Common connection, OAuth, and tool-call errors: [docs/troubleshooting.md](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](LICENSE).

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