[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_109":110},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95},"apiUrl","https://odel.app/api","creator","sultanlive","moduleId","vibeseo-mcp","@sultanlive/vibeseo-mcp","displayName","VibeSEO","tagline","SEO research, audits, backlinks, GSC, and content workflow tools for AI agents.","iconKey","https://vibeseo.dev/brand/vibeseo-icon.svg","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.vibeseo.dev/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363298000,"updatedAt",1788769960000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=dev.vibeseo%2Fvibeseo","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",2,"upstreamUpdatedAt",1783938587000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/sultanlive/vibeseo-mcp","githubRepoFullName","sultanlive/vibeseo-mcp","releaseId","ext-sultanlive-vibeseo-mcp","version","0.1.3","descriptionMarkdown","**en** • [es](https://github.com/sultanlive/vibeseo-mcp/blob/main/README.es.md) • [de](https://github.com/sultanlive/vibeseo-mcp/blob/main/README.de.md) • [ja](https://github.com/sultanlive/vibeseo-mcp/blob/main/README.ja.md) • [fr](https://github.com/sultanlive/vibeseo-mcp/blob/main/README.fr.md) • [pt](https://github.com/sultanlive/vibeseo-mcp/blob/main/README.pt.md) • [ru](https://github.com/sultanlive/vibeseo-mcp/blob/main/README.ru.md) • [it](https://github.com/sultanlive/vibeseo-mcp/blob/main/README.it.md) • [nl](https://github.com/sultanlive/vibeseo-mcp/blob/main/README.nl.md) • [pl](https://github.com/sultanlive/vibeseo-mcp/blob/main/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 $\"Cursor\"$ $\"VS$ $\"Claude\"$ $\"ChatGPT\"$ \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](https://github.com/sultanlive/vibeseo-mcp/blob/main/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](https://github.com/sultanlive/vibeseo-mcp/blob/main/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](https://github.com/sultanlive/vibeseo-mcp/blob/main/docs/oauth.md).\n\n## Troubleshooting\n\nCommon connection, OAuth, and tool-call errors: [docs/troubleshooting.md](https://github.com/sultanlive/vibeseo-mcp/blob/main/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](https://github.com/sultanlive/vibeseo-mcp/blob/main/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","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_98":99,"_100":101,"_102":-5,"_103":104,"_105":106,"_107":108},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","topics",[],"license","MIT","language","registryName","dev.vibeseo/vibeseo","homepage","https://vibeseo.dev/mcp","packages",[],"ENV",{"_111":112,"_113":114,"_115":116},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]