Summary
Remote OAuth-secured MCP that connects Claude, ChatGPT, Cursor, or VS Code to VibeSEO's API for live SEO work. Ask for keyword research with volume and difficulty, run site audits and read crawl issues, pull backlink profiles and referring domains, query Google Search Console data for connected properties, or manage content workflow from idea generation to scheduling. Each tool maps directly to VibeSEO's platform features. Auth is OAuth 2.1 with PKCE, tokens are revocable per client, and the approval gate for publishing stays inside VibeSEO. Reach for this when you want conversational access to a full SEO research and content ops stack without leaving your editor or chat interface.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
70 tools
get_location_by_codeLook up a single location by its DataForSEO location code, e.g. 2840 for United States.1 params
Look up a single location by its DataForSEO location code, e.g. 2840 for United States.
Parameters* required
codeintegerscore_keywordScore a candidate keyword against this project's archetype to get a 0-100 priority score with breakdown. The keyword must already appear in the project's top-100 ranking set.2 params
Score a candidate keyword against this project's archetype to get a 0-100 priority score with breakdown. The keyword must already appear in the project's top-100 ranking set.
Parameters* required
keywordstringKeyword to score. Must be one the project already ranks for in the top 100.
projectIdintegerupdate_site_informationSave the project's site information. All optional fields default to existing values when omitted.18 params
Save the project's site information. All optional fields default to existing values when omitted.
Parameters* required
summarystringfoundersstringsiteTypestringSite type: SaaS, Ecommerce, Marketplace, Blog, Newsroom, Service, Education, Nonprofit, Other.one of
Unknown · Saas · Ecommerce · Educational · Entertainment · FinancialServicesblogThemestringprojectIdintegerpainPointsstringkeyFeaturesstringctaButtonUrlstringpricingPlansstringproductUsagestringctaButtonTextstringctaButtonStylestringCTA style: Primary, Secondary, Outline, or Ghost.one of
Primary · Secondary · Inlinedefault: PrimaryprimaryCountrystringPrimary country code, e.g. "US".
siteTypeCustomstringCustom site type label (only required when siteType=Other).
audienceSummarystringprimaryLanguagestringPrimary language code, e.g. "en".
mainImageBrandingDescriptionstringinlineImageBrandingDescriptionstringlist_languagesList supported languages (language code + display name).
List supported languages (language code + display name).
No parameter schema in public metadata yet.
list_publicationsList published article snapshots (read-only history) for the project, with traffic signals.1 params
List published article snapshots (read-only history) for the project, with traffic signals.
Parameters* required
projectIdintegergsc_query_detailsGSC performance for a specific list of queries.3 params
GSC performance for a specific list of queries.
Parameters* required
daysintegerWindow in days. Defaults to 28.
queriesarrayprojectIdintegerlist_domain_historyReturn the calling user's recent domain search history.
Return the calling user's recent domain search history.
No parameter schema in public metadata yet.
keyword_gapKeywords the competitor ranks for that the primary domain doesn't (highest-opportunity gap targets), or common keywords. Returns { totalCount, items }.6 params
Keywords the competitor ranks for that the primary domain doesn't (highest-opportunity gap targets), or common keywords. Returns { totalCount, items }.
Parameters* required
modestringGap (default — they rank, we don't) or Common (both rank).one of
Gap · CommonlimitintegerMax keywords to return. Defaults to 100.
domainstringPrimary domain.
competitorstringSingle competitor domain.
languageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
list_audit_issuesFiltered list of issues from an audit. Filter by category (on-page, technical, content, performance, ...) or severity (critical, warning, info).3 params
Filtered list of issues from an audit. Filter by category (on-page, technical, content, performance, ...) or severity (critical, warning, info).
Parameters* required
auditIdintegercategorystringOptional category filter, e.g. "technical".
severitystringOptional severity filter: "critical", "warning", or "info".
autocomplete_keywords_batchBulk autocomplete suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.10 params
Bulk autocomplete suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordsarrayBetween 1 and 5 seed keywords. Hard cap of 5 enforced server-side; anything more is rejected with HTTP 400.
volumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
autocomplete_keywordsGoogle-autocomplete-style keyword suggestions for a seed keyword. Filter results by volume, CPC, difficulty, intent. Each suggestion comes back with its own locationCode/languageCode — use this tool (or related_keywords) to discover the right market before calling get_keyword_...10 params
Google-autocomplete-style keyword suggestions for a seed keyword. Filter results by volume, CPC, difficulty, intent. Each suggestion comes back with its own locationCode/languageCode — use this tool (or related_keywords) to discover the right market before calling get_keyword_...
Parameters* required
sdMaxintegerMaximum keyword difficulty (0-100).
sdMinintegerMinimum keyword difficulty (0-100).
cpcMaxnumberMaximum CPC in USD.
cpcMinnumberMinimum CPC in USD.
intentstringComma-separated intent filter, e.g. "informational,commercial".
keywordstringSeed keyword.
volumeMaxintegerMaximum monthly search volume.
volumeMinintegerMinimum monthly search volume.
languageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
question_keywordsQuestion-format suggestions (what/how/why/when/...) for a seed keyword. Useful for FAQ and informational content.10 params
Question-format suggestions (what/how/why/when/...) for a seed keyword. Useful for FAQ and informational content.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordstringvolumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
comparison_keywords_batchBulk comparison-style suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.10 params
Bulk comparison-style suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordsarrayBetween 1 and 5 seed keywords. Hard cap of 5 enforced server-side; anything more is rejected with HTTP 400.
volumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
clear_domain_historyClear the calling user's domain search history.
Clear the calling user's domain search history.
No parameter schema in public metadata yet.
gsc_top_queriesTop search queries from GSC for a project.3 params
Top search queries from GSC for a project.
Parameters* required
daysintegerWindow in days. Defaults to 90.
limitintegerMax queries. Defaults to 25.
projectIdintegerdomain_traffic_historyMonthly organic traffic history for a domain.3 params
Monthly organic traffic history for a domain.
Parameters* required
domainstringlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
reject_postReject a Ready post: clears the body and returns it to Drafting with the reason recorded.2 params
Reject a Ready post: clears the body and returns it to Drafting with the reason recorded.
Parameters* required
postIdintegerreasonstringgsc_statusGSC connection status for a project: connected/pending/invalid, bound site, last sync time.1 params
GSC connection status for a project: connected/pending/invalid, bound site, last sync time.
Parameters* required
projectIdintegerlist_competitorsList the project's tracked competitors.1 params
List the project's tracked competitors.
Parameters* required
projectIdintegerbacklink_historyHistorical backlink count trend for the domain.1 params
Historical backlink count trend for the domain.
Parameters* required
domainstringrefill_queueAppend new Idea-status posts to the queue (additive — does not touch existing posts).2 params
Append new Idea-status posts to the queue (additive — does not touch existing posts).
Parameters* required
countintegerHow many ideas to add. Defaults to ~12.
projectIdintegerlist_audits_for_projectAll audits previously run for a project, newest first.1 params
All audits previously run for a project, newest first.
Parameters* required
projectIdintegerlist_gsc_sitesList Google Search Console sites accessible via a previously-connected GSC connection.1 params
List Google Search Console sites accessible via a previously-connected GSC connection.
Parameters* required
connectionIdintegerget_audit_summaryCondensed audit scorecard: category breakdown, top recurring rule codes, average response time, indexable pages percent.1 params
Condensed audit scorecard: category breakdown, top recurring rule codes, average response time, indexable pages percent.
Parameters* required
auditIdintegerget_projectGet a single project by ID.1 params
Get a single project by ID.
Parameters* required
idintegerlist_projectsList the calling user's VibeSEO projects.
List the calling user's VibeSEO projects.
No parameter schema in public metadata yet.
get_auditAudit metadata + summary scores by audit ID.1 params
Audit metadata + summary scores by audit ID.
Parameters* required
auditIdintegeranalyze_for_onboardingRun the onboarding analyzer on a domain: surfaces opportunity gaps, audit issues, and competitor insights as initial recommendations.1 params
Run the onboarding analyzer on a domain: surfaces opportunity gaps, audit issues, and competitor insights as initial recommendations.
Parameters* required
domainstringDomain to analyze, e.g. "example.com".
update_projectRename or change the domain of an existing project.3 params
Rename or change the domain of an existing project.
Parameters* required
idintegernamestringdomainstringstart_site_auditTrigger a new site audit (crawl + on-page/technical analysis). Runs asynchronously; poll get_audit until status="completed".2 params
Trigger a new site audit (crawl + on-page/technical analysis). Runs asynchronously; poll get_audit until status="completed".
Parameters* required
maxPagesintegerMaximum number of pages to crawl. Optional.
projectIdintegerclear_keyword_historyClear the calling user's keyword search history.
Clear the calling user's keyword search history.
No parameter schema in public metadata yet.
question_keywords_batchBulk question-format suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.10 params
Bulk question-format suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordsarrayBetween 1 and 5 seed keywords. Hard cap of 5 enforced server-side; anything more is rejected with HTTP 400.
volumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
gsc_top_pagesTop landing pages from GSC for a project.3 params
Top landing pages from GSC for a project.
Parameters* required
daysintegerWindow in days. Defaults to 90.
limitintegerMax pages. Defaults to 25.
projectIdintegerdomain_competitor_suggestionsSuggested competitor domains based on keyword overlap and similar audience.4 params
Suggested competitor domains based on keyword overlap and similar audience.
Parameters* required
limitintegerMax number of competitors. Defaults to 20.
domainstringlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
backlink_anchorsTop anchor texts pointing at the domain.2 params
Top anchor texts pointing at the domain.
Parameters* required
limitintegerMax anchors to return. Defaults to 100.
domainstringdelete_projectDelete a project. This action is irreversible.1 params
Delete a project. This action is irreversible.
Parameters* required
idintegerget_keyword_metricsKEYWORD DIFFICULTY REQUIRES locationCode AND languageCode — worldwide calls (both omitted) return null KD. If the target market is unknown, first call autocomplete_keywords or related_keywords; their results include locationCode/languageCode per suggestion, which you can then...3 params
KEYWORD DIFFICULTY REQUIRES locationCode AND languageCode — worldwide calls (both omitted) return null KD. If the target market is unknown, first call autocomplete_keywords or related_keywords; their results include locationCode/languageCode per suggestion, which you can then...
Parameters* required
keywordstringKeyword to look up, e.g. "best running shoes".
languageCodestringISO language code, e.g. "en". REQUIRED (together with locationCode) to get keyword difficulty — omit both only if KD is not needed.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. REQUIRED (together with languageCode) to get keyword difficulty — omit both only if KD is not needed.
propose_site_informationRun the AI strategist to propose site information values from the latest crawl.1 params
Run the AI strategist to propose site information values from the latest crawl.
Parameters* required
projectIdintegerget_keyword_metrics_batchMAX 5 KEYWORDS PER CALL. Sending 6 or more returns a 400 validation error — split larger lists across multiple calls. KEYWORD DIFFICULTY REQUIRES locationCode AND languageCode — worldwide calls (both omitted) return null KD for every keyword. If the target market is unknown, f...3 params
MAX 5 KEYWORDS PER CALL. Sending 6 or more returns a 400 validation error — split larger lists across multiple calls. KEYWORD DIFFICULTY REQUIRES locationCode AND languageCode — worldwide calls (both omitted) return null KD for every keyword. If the target market is unknown, f...
Parameters* required
keywordsarrayBetween 1 and 5 keywords. Hard cap of 5 enforced server-side; anything more is rejected with HTTP 400.
languageCodestringISO language code, e.g. "en". REQUIRED (together with locationCode) to get keyword difficulty — omit both only if KD is not needed.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. REQUIRED (together with languageCode) to get keyword difficulty — omit both only if KD is not needed.
list_keyword_historyReturn the calling user's recent keyword search history.
Return the calling user's recent keyword search history.
No parameter schema in public metadata yet.
backlink_profileAggregate backlink profile for a domain: total backlinks, referring domains, spam score, broken links.1 params
Aggregate backlink profile for a domain: total backlinks, referring domains, spam score, broken links.
Parameters* required
domainstringDomain to analyze.
preposition_keywordsSuggestions containing prepositions (for/with/near/...) for a seed keyword.10 params
Suggestions containing prepositions (for/with/near/...) for a seed keyword.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordstringvolumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
schedule_postSet or change the scheduled_for date on a post (Idea, Drafting, or Ready).2 params
Set or change the scheduled_for date on a post (Idea, Drafting, or Ready).
Parameters* required
postIdintegerscheduledForstringNew scheduled publish time (UTC ISO 8601). Pass null to unschedule.
gsc_trendDaily GSC trend (clicks, impressions, position) over a window.2 params
Daily GSC trend (clicks, impressions, position) over a window.
Parameters* required
projectIdintegerwindowDaysintegerWindow in days. Defaults to 90.
approve_postApprove a Ready post and queue it for publication at its scheduled time.1 params
Approve a Ready post and queue it for publication at its scheduled time.
Parameters* required
postIdintegerdomain_overviewAuthority, organic/paid traffic estimate, keyword count, backlink count, and rank distribution for a domain.3 params
Authority, organic/paid traffic estimate, keyword count, backlink count, and rank distribution for a domain.
Parameters* required
domainstringDomain to analyze, e.g. "example.com".
languageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
search_locationsSearch countries and cities by name. Useful for resolving a city name to its DataForSEO location code.2 params
Search countries and cities by name. Useful for resolving a city name to its DataForSEO location code.
Parameters* required
limitintegerMax results.
querystringFree-text search, e.g. "new york".
create_projectCreate a new VibeSEO project for a domain.2 params
Create a new VibeSEO project for a domain.
Parameters* required
namestringDisplay name for the project.
domainstringRoot domain, e.g. "example.com".
get_publicationRead a single publication snapshot including daily impression/click signals.1 params
Read a single publication snapshot including daily impression/click signals.
Parameters* required
publicationIdintegergsc_summaryAggregate GSC performance for the project over a window: clicks, impressions, CTR, avg position, deltas vs previous period.2 params
Aggregate GSC performance for the project over a window: clicks, impressions, CTR, avg position, deltas vs previous period.
Parameters* required
projectIdintegerwindowDaysintegerWindow in days. Defaults to 90.
comparison_keywordsComparison-style suggestions ("X vs Y", "X alternative", ...) for a seed keyword.10 params
Comparison-style suggestions ("X vs Y", "X alternative", ...) for a seed keyword.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordstringvolumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
list_postsList posts for a project. Filter by status: Idea, Drafting, Ready, Approved, Published.2 params
List posts for a project. Filter by status: Idea, Drafting, Ready, Approved, Published.
Parameters* required
statusstringone of
Idea · Drafting · Ready · Approved · PublishedprojectIdintegergenerate_postTrigger AI draft generation for a scheduled Idea or Drafting post. Returns the post ID.1 params
Trigger AI draft generation for a scheduled Idea or Drafting post. Returns the post ID.
Parameters* required
postIdintegerget_postRead a single post (markdown body, FAQ, internal links, SEO score, status, schedule).1 params
Read a single post (markdown body, FAQ, internal links, SEO score, status, schedule).
Parameters* required
postIdintegerpreposition_keywords_batchBulk preposition-style suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.10 params
Bulk preposition-style suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordsarrayBetween 1 and 5 seed keywords. Hard cap of 5 enforced server-side; anything more is rejected with HTTP 400.
volumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
list_crawled_pagesTop crawled pages from the project's most recent completed audit (URL, title, meta, word count). Useful for fact-checking and finding internal-link targets.2 params
Top crawled pages from the project's most recent completed audit (URL, title, meta, word count). Useful for fact-checking and finding internal-link targets.
Parameters* required
limitintegerMax pages to return. Defaults to 25.
projectIdintegerrefresh_ideasReplace existing Idea-status posts with a fresh strategist-generated batch. Drafting/Ready/Approved/Published posts are untouched.2 params
Replace existing Idea-status posts with a fresh strategist-generated batch. Drafting/Ready/Approved/Published posts are untouched.
Parameters* required
countintegerHow many ideas to suggest. Defaults to ~12.
projectIdintegerbacklink_referring_domainsPaginated list of domains linking to the target.3 params
Paginated list of domains linking to the target.
Parameters* required
pageintegerPage number, 1-based. Defaults to 1.
domainstringpageSizeintegerPage size. Defaults to 50.
create_publishing_targetAdd a new publishing target (Subdomain or CustomDomain).3 params
Add a new publishing target (Subdomain or CustomDomain).
Parameters* required
typestringType: Subdomain or CustomDomain.one of
CustomDomain · WordPresshostnamestringHostname, e.g. "blog.example.com" or "my-site" for a subdomain.
projectIdintegercompetitive_overviewSide-by-side metrics for a primary domain and its competitors: traffic, keywords, backlinks, common keywords, gap size, monthly trend.4 params
Side-by-side metrics for a primary domain and its competitors: traffic, keywords, backlinks, common keywords, gap size, monthly trend.
Parameters* required
domainstringPrimary domain.
competitorsarrayCompetitor domains to compare against.
languageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
list_countriesList supported DataForSEO country locations (location codes + ISO codes).
List supported DataForSEO country locations (location codes + ISO codes).
No parameter schema in public metadata yet.
related_keywords_batchBulk synonym-expansion suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.10 params
Bulk synonym-expansion suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordsarrayBetween 1 and 5 seed keywords. Hard cap of 5 enforced server-side; anything more is rejected with HTTP 400.
volumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
get_site_informationRead the project's site information record (brand, audience, pain points, CTAs).1 params
Read the project's site information record (brand, audience, pain points, CTAs).
Parameters* required
projectIdintegerrelated_keywordsSynonym-expansion related keywords for a seed keyword. Each suggestion comes back with its own locationCode/languageCode — use this tool (or autocomplete_keywords) to discover the right market before calling get_keyword_metrics for keyword difficulty.10 params
Synonym-expansion related keywords for a seed keyword. Each suggestion comes back with its own locationCode/languageCode — use this tool (or autocomplete_keywords) to discover the right market before calling get_keyword_metrics for keyword difficulty.
Parameters* required
sdMaxintegersdMinintegercpcMaxnumbercpcMinnumberintentstringkeywordstringvolumeMaxintegervolumeMinintegerlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
get_month_viewRead all posts scheduled in a given month, grouped for calendar display.2 params
Read all posts scheduled in a given month, grouped for calendar display.
Parameters* required
projectIdintegermonthStartstringMonth start (YYYY-MM-DD). Defaults to current month.
list_publishing_targetsList subdomains and custom domains the project can publish to.1 params
List subdomains and custom domains the project can publish to.
Parameters* required
projectIdintegerdomain_top_pagesTop pages on the domain by estimated organic traffic.4 params
Top pages on the domain by estimated organic traffic.
Parameters* required
limitintegerMax number of pages to return. Defaults to 50.
domainstringlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
replace_competitorsReplace the project's competitor list with the supplied set of domains.2 params
Replace the project's competitor list with the supplied set of domains.
Parameters* required
domainsarrayprojectIdintegerlist_citiesList cities supported within a country. Country code is ISO 3166-1 alpha-2, e.g. "US".1 params
List cities supported within a country. Country code is ISO 3166-1 alpha-2, e.g. "US".
Parameters* required
countryCodestringdomain_top_keywordsTop organic keywords the domain ranks for, with position, volume, traffic, and SERP features.4 params
Top organic keywords the domain ranks for, with position, volume, traffic, and SERP features.
Parameters* required
limitintegerMax number of keywords to return. Defaults to 100.
domainstringlanguageCodestringISO language code, e.g. "en". Must be provided together with locationCode, or both omitted for worldwide.
locationCodeintegerDataForSEO location code, e.g. 2840 for United States. Must be provided together with languageCode, or both omitted for worldwide.
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 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.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
