{
  "markdown": "**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)\n\n# VibeSEO MCP\n\n**Model Context Protocol server for SEO research, audits, and content workflow — secured by OAuth.**\n\nVibeSEO 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.\n\n- **Server URL:** `https://mcp.vibeseo.dev/mcp`\n- **Transport:** Streamable HTTP\n- **Auth:** OAuth 2.1 with PKCE, scope `mcp:tools`\n- **Landing & setup:** [vibeseo.dev/mcp](https://vibeseo.dev/mcp)\n\n## Install\n\nVibeSEO MCP is a **remote, OAuth-secured** server. Add this to your client's MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"vibeseo\": {\n      \"url\": \"https://mcp.vibeseo.dev/mcp\"\n    }\n  }\n}\n```\n\n**One-click install:**\n\n<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>&nbsp;&nbsp;<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>&nbsp;&nbsp;<a href=\"https://claude.ai/settings/connectors\"><img src=\"https://vibeseo.dev/icons/claude-desktop.svg\" width=\"36\" alt=\"Claude\"></a>&nbsp;&nbsp;<a href=\"https://chatgpt.com/settings/connectors\"><img src=\"https://vibeseo.dev/icons/chatgpt-icon.svg\" width=\"36\" alt=\"ChatGPT\"></a>\n\nCLI clients (Claude Code, Gemini CLI, Codex CLI) and manual snippets: see [Supported clients](#supported-clients).\n\n## Quick start\n\n1. Create a VibeSEO account at [vibeseo.dev](https://vibeseo.dev) and start a trial — $0 today, card required (see [Plans & access](#plans--access)).\n2. Open the [VibeSEO MCP page](https://vibeseo.dev/mcp) and follow the setup link for your client.\n3. Use the one-click install, copied CLI command, or manual JSON/TOML snippet.\n4. Authorize with OAuth when your client opens the consent screen.\n5. Ask your assistant for SEO work in natural language.\n\n## What you can do from chat\n\n- **🔍 Keyword research** — volumes, CPC, difficulty, intent, autocomplete ideas, question keywords, comparisons, and related terms.\n- **🌐 Domain analysis** — domain overview, top keywords, top pages, traffic history, and competitor suggestions.\n- **🛠️ Site audits** — start audits, read crawl results, list issues, and prioritize fixes.\n- **📈 GSC performance** — connected Google Search Console summaries, top queries, top pages, trends, and query-level diagnostics.\n- **🔗 Backlinks** *(Pro)* — profile, referring domains, anchor text, and history of any domain.\n- **🚀 Content workflow** *(Pro)* — list posts, refresh ideas, generate drafts, approve ready articles, schedule, and review.\n\n## Tool surface\n\nThe MCP server maps to the same SEO workflow inside VibeSEO. Categories:\n\n| Category | What it covers |\n|---|---|\n| 📁 **Projects** | List projects, read project and site information, list and replace tracked competitors. |\n| 🔍 **Keywords** | Metrics, autocomplete, related, question, preposition and comparison keywords, lookup history. |\n| 🌐 **Domains** | Overview, top keywords, top pages, traffic history, competitor ideas, lookup history. |\n| 🧯 **Audits** | Start site audits, read summaries, list issues, inspect crawled pages. |\n| 📊 **GSC** | Connection status, summaries, top queries, top pages, trends, query details. |\n| ⚔️ **Competitive** | Competitive overview and keyword gap analysis across domains. |\n| 📍 **Locations** | Countries, languages, locations, city lookups, location codes for market-specific research. |\n| 🔗 **Backlinks** *(Pro)* | Profile, referring domains, anchors, backlink history. |\n| ✍️ **Content** *(Pro)* | Ideas, drafts, approvals, scheduling, content calendar, publications, keyword scoring. |\n\nThe live tool set evolves. For the exact, up-to-date list, run `tools/list` against `https://mcp.vibeseo.dev/mcp`.\n\n## Plans & access\n\nThe 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.\n\n| | Trial | SEO Researcher | Pro |\n|---|---|---|---|\n| **Price** | $0 today, card required | $9/mo | $39/mo |\n| Keywords, domains, audits, GSC, competitive, locations | ✅ | ✅ | ✅ |\n| Backlink data | — | — | ✅ |\n| AI content workflow (ideas, drafts, publishing) | — | — | ✅ |\n| Monthly credits | 40 | 400 | 1500 |\n\nThe 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](https://vibeseo.dev/pricing) for the current plans.\n\n**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.\n\n## Supported clients\n\nSetup paths for each:\n\n- **Claude** (web & desktop) — Connectors page or `claude_desktop_config.json`\n- **ChatGPT** — custom MCP connector with OAuth\n- **Cursor** — one-click install via deeplink, or `~/.cursor/mcp.json`\n- **VS Code** — one-click install via deeplink, or `.vscode/mcp.json`\n- **Claude Code (CLI)** — `claude mcp add --transport http vibeseo https://mcp.vibeseo.dev/mcp`\n- **Gemini CLI** — `gemini mcp add --transport http vibeseo https://mcp.vibeseo.dev/mcp`\n- **Codex CLI** — `codex mcp add vibeseo --url https://mcp.vibeseo.dev/mcp`\n- **Generic HTTP MCP client** — point at the URL, let it complete OAuth discovery\n\nFull per-client install instructions: [docs/setup.md](docs/setup.md).\n\n## Cursor plugin\n\nThis repository is also a Cursor plugin. It contributes one MCP server (`vibeseo`) and no rules, skills, agents, or hooks.\n\n```\n.cursor-plugin/plugin.json   ← plugin manifest\nmcp.json                     ← the MCP server it contributes\nassets/logo.svg              ← plugin logo\n```\n\n`mcp.json` points Cursor at the hosted server:\n\n```json\n{\n  \"mcpServers\": {\n    \"vibeseo\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.vibeseo.dev/mcp\"\n    }\n  }\n}\n```\n\nThere 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).\n\n## Example prompts\n\n**Keyword plan**\n> \"Find comparison keywords for my invoicing app that are realistic to rank for.\"\n\n→ VibeSEO returns a prioritized topic list (commercial intent, lower difficulty, comparison angle).\n\n**Technical audit**\n> \"Audit my project and tell me what to fix before publishing more articles.\"\n\n→ VibeSEO turns crawl data into next actions (missing canonicals, oversized images, internal-link gaps).\n\n**Publish queue**\n> \"Show ready posts, generate the next draft, and schedule the strongest one.\"\n\n→ VibeSEO manages the content workflow (counts of Ready/Drafting, schedules the next approved article).\n\nMore: [docs/examples.md](docs/examples.md).\n\n## Authorization & approval gate\n\nAuth 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](https://vibeseo.dev/mcp) under \"Connected clients\" — disconnecting a client revokes its access immediately.\n\n**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.\n\nOAuth flow details: [docs/oauth.md](docs/oauth.md).\n\n## Troubleshooting\n\nCommon connection, OAuth, and tool-call errors: [docs/troubleshooting.md](docs/troubleshooting.md).\n\n## Project links\n\n- Product: [vibeseo.dev](https://vibeseo.dev)\n- VibeSEO MCP page: [vibeseo.dev/mcp](https://vibeseo.dev/mcp)\n- MCP server: `https://mcp.vibeseo.dev/mcp`\n- OAuth issuer: `https://api.vibeseo.dev`\n- Issues: [github.com/sultanlive/vibeseo-mcp/issues](https://github.com/sultanlive/vibeseo-mcp/issues)\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n---\n\nBuilt by [@sultanlive](https://github.com/sultanlive). VibeSEO is a hosted SEO platform; this repo is documentation for its public MCP server. Server source is not open.\n",
  "bytes": 8714,
  "sha": "77deec1ff228bfd45d8986e55183705e7f2690298da6b2fb152f3569ba907a0e",
  "repo_slug": "sultanlive/vibeseo-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_vibeseo_vibeseo_8d524bbb/readme"
}