MCP App Store
by KeenEthics
SEO Keywords by VibeSEO icon

SEO Keywords by VibeSEO MCP Server for Claude and ChatGPT

By Sultan Kadyrkesh

Overview

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.

How to connect

  1. Claude: Open the SEO Keywords by VibeSEO listing in the Claude connectors directory and choose Connect. Claude listing SEO Keywords by VibeSEO exposes 53 tools here.
  2. ChatGPT: Open the SEO Keywords by VibeSEO listing in the ChatGPT app directory and choose Connect. ChatGPT listing SEO Keywords by VibeSEO exposes 64 tools here.

Tools

apply_translation_update

ChatGPT
Replace a translated article's text with a pending translation update (a candidate listed by get_translations). Applying does not publish; approve the result with approve_translation. Fails when the translation was edited after the update was generated, so manual edits are never overwritten; discard the update with discard_translation_update to keep them. Returns the article's language versions.

approve_post

ChatGPT
Approve a Ready post and queue it for publication at its scheduled time. Returns the updated post.

approve_translation

ChatGPT
Approve a translated article's current text for publication: VibeSEO publishes it to the project's connected site (its blog or CMS) once the original article is published. Returns the article's language versions.

autocomplete_keywords

ChatGPT
Google-autocomplete-style keyword suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls. Each suggestion comes back with its own locationCode/languageCode — use this tool (or related_keywords) to discover the right market before calling get_keyword_metrics for keyword difficulty. Filter results by volume, CPC, difficulty, intent.

comparison_keywords

ChatGPT
Comparison-style suggestions ("X vs Y", "X alternative", ...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.

competitive_overview

ChatGPT
Side-by-side metrics for a primary domain and its competitors: traffic, keywords, backlinks, common keywords, gap size, monthly trend.

create_post

ChatGPT
Create a post from an article you wrote yourself, stored directly in Ready status. Creating a post costs no credits: it runs no strategist or AI generation, so the text is published exactly as you pass it. The slug is built from the title when omitted; if the slug is already used in the project, the call fails and you must pass a different slug (a title without Latin letters or digits needs an explicit slug). The SEO score stays empty and no automatic translations are queued. Nothing is published yet: set a date with schedule_post, then approve_post queues it for the project's connected site, or publish_post_now after approving. Returns the new post in the get_post format.

discard_translation_update

ChatGPT
Drop a pending translation update (a candidate listed by get_translations) and keep the translated article's current text. Returns the article's language versions.

domain_competitor_suggestions

ChatGPT
Suggested competitor domains based on keyword overlap and similar audience.

domain_overview

ChatGPT
Authority, organic/paid traffic estimate, keyword count, backlink count, and rank distribution for a domain.

domain_top_keywords

ChatGPT
Top organic keywords the domain ranks for, with position, volume, traffic, and SERP features.

domain_top_pages

ChatGPT
Top pages on the domain by estimated organic traffic.

domain_traffic_history

ChatGPT
Monthly organic traffic history for a domain.

generate_post

ChatGPT
Trigger AI draft generation for a scheduled Idea or Drafting post. Returns the post ID.

get_audit

ChatGPT
Audit metadata + summary scores by audit ID.

get_audit_summary

ChatGPT
Condensed audit scorecard: category breakdown, top recurring rule codes, average response time, indexable pages percent.

get_keyword_metrics

ChatGPT
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, first call autocomplete_keywords or related_keywords; their results include locationCode/languageCode per suggestion, which you can then pass back here. Looks up search volume, CPC, KD, and intent for 1 to 5 keywords.

get_location_by_code

ChatGPT
Look up a single location by its DataForSEO location code, e.g. 2840 for United States.

get_month_view

ChatGPT
Read all posts scheduled in a given month, grouped for calendar display.

get_post

ChatGPT
Read a single post (markdown body, FAQ, internal links, SEO score, status, schedule).

get_project

ChatGPT
Get a single project by ID.

get_publication

ChatGPT
Read a single publication snapshot including daily impression/click signals.

get_site_information

ChatGPT
Read the project's site information record (brand, audience, pain points, CTAs).

get_translation_settings

ChatGPT
Read the blog's configured languages and translation price.

get_translations

ChatGPT
Read linked language versions, stale status and translation candidates for an article.

gsc_query_details

ChatGPT
GSC performance for a specific list of queries.

gsc_status

ChatGPT
GSC connection status for a project: connected/pending/invalid, bound site, last sync time. Call this before gsc_summary or gsc_top_* to detect a missing connection cheaply.

gsc_summary

ChatGPT
Aggregate GSC performance for the project over a window: clicks, impressions, CTR, avg position, deltas vs previous period.

gsc_top_pages

ChatGPT
Top landing pages from GSC for a project.

gsc_top_queries

ChatGPT
Top search queries from GSC for a project.

gsc_trend

ChatGPT
Daily GSC trend (clicks, impressions, position) over a window.

keyword_gap

ChatGPT
Keywords the competitor ranks for that the primary domain doesn't (highest-opportunity gap targets), or common keywords. Returns { totalCount, items }.

list_audit_issues

ChatGPT
Filtered list of issues from an audit. Filter by category (on-page, technical, content, performance, ...) or severity (critical, warning, info).

list_audits_for_project

ChatGPT
All audits previously run for a project, newest first.

list_cities

ChatGPT
List cities supported within a country. Country code is ISO 3166-1 alpha-2, e.g. "US".

list_competitors

ChatGPT
List the project's tracked competitors.

list_countries

ChatGPT
List supported DataForSEO country locations (location codes + ISO codes).

list_crawled_pages

ChatGPT
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.

list_domain_history

ChatGPT
Return the calling user's recent domain search history.

list_keyword_history

ChatGPT
Return the calling user's recent keyword search history.

list_languages

ChatGPT
List supported languages (language code + display name).

list_posts

ChatGPT
List posts for a project. Filter by status: Idea, Drafting, Ready, Approved, Published.

list_projects

ChatGPT
List the calling user's VibeSEO projects.

list_publications

ChatGPT
List published article snapshots (read-only history) for the project, with traffic signals.

mark_post_ready

ChatGPT
Move an Idea or Drafting post whose body you wrote (with update_post) to Ready, without changing its text. Costs no credits and runs no AI generation. Call get_post first and pass its contentRevision as expectedRevision. Fails if the body is empty, the post is still being generated, its status is not Idea or Drafting, it was edited since you read it (then call get_post again), or another post in the project already uses its slug (change the slug with update_post first). Then approve_post queues it for publication. Returns the updated post.

preposition_keywords

ChatGPT
Suggestions containing prepositions (for/with/near/...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.

publish_post_now

ChatGPT
Publish a post to the project's connected site (its blog or CMS) immediately. Only call it when the user asks to publish now. An Approved post goes live now instead of at its scheduled time. A Published post is republished, replacing the live version with its latest edits (use it after update_post when the post shows hasUnpublishedChanges). Works only on Approved or Published posts: approve a Ready post with approve_post first. A translated article cannot be published this way; it goes live through approve_translation once its original is published. Publishing runs in the background and takes a few seconds: the returned post may still show the old state, so confirm with get_post (status Published, hasUnpublishedChanges false). Returns the post.

question_keywords

ChatGPT
Question-format suggestions (what/how/why/when/...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls. Useful for FAQ and informational content.

refill_queue

ChatGPT
Queue an async strategist job that appends new Idea-status posts to the queue (additive — does not touch existing posts). Returns a job acceptance immediately; new Idea posts appear in list_posts within ~30–60 seconds.

refresh_ideas

ChatGPT
Queue an async strategist job that replaces existing Idea-status posts with a fresh batch (Drafting/Ready/Approved/Published are untouched). Returns a job acceptance immediately; new Idea posts appear in list_posts within ~30–60 seconds.

reject_post

ChatGPT
Reject a Ready post: clears the body and returns it to Drafting with the reason recorded. Returns the updated post.

replace_competitors

ChatGPT
Replace the project's competitor list with the supplied set of domains. Returns the new competitor list.

save_translation_settings

ChatGPT
Save the primary language and translation languages together. Read get_translation_settings first; include the enabled primary language and keep existing disabled languages in the list. Supply primaryLanguage when the project has none; omit it to preserve the current language. Renderer URLs are managed automatically. Saving settings does not generate articles or charge credits. Enabled additional languages generate reviewable translations of future originals at 20 credits per language; existing articles are not translated automatically.

schedule_post

ChatGPT
Set or change the scheduled_for date on a post (Idea, Drafting, or Ready). Returns the updated post. To remove a scheduled date, call unschedule_post instead.

score_keyword

ChatGPT
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.

search_locations

ChatGPT
Search countries and cities by name. Useful for resolving a city name to its DataForSEO location code.

start_site_audit

ChatGPT
Trigger a new site audit (crawl + on-page/technical analysis). Runs asynchronously; poll get_audit until status="completed".

translate_articles

ChatGPT
Translate selected original posts into configured languages. Each new or refreshed translation costs 20 credits and requires review before publication. Refresh creates a candidate without overwriting manual edits. Returns the ids of the translated articles; translation runs in the background, so read them with get_translations and publish with approve_translation.

unschedule_post

ChatGPT
Clear the scheduled_for date on a post (Idea, Drafting, or Ready), returning it to the unscheduled state. Returns the updated post. Content is preserved.

update_post

ChatGPT
Edit a post's text, SEO fields and images. Call get_post first and pass its contentRevision as expectedRevision. Only the fields you pass change; omitted, null or empty fields keep their current value. To remove an optional field, name it in clearFields. If the post was edited since you read it (in the web editor or by another call), the update fails with a conflict: call get_post again and reapply your changes to the new text instead of retrying blindly. A post that is still being generated (Drafting) cannot be edited. Editing costs no credits. Editing an Approved post changes what VibeSEO publishes to the project's connected site at its scheduled time. Editing a Published post does not change the live site: the post shows hasUnpublishedChanges until it is republished from the VibeSEO web app. Editing an original article marks its translations outdated: refresh them with translate_articles (refresh=true), then apply_translation_update and approve_translation; refreshed translations take the original's hero and OG images. Returns the updated post.

approve_post

Claude

autocomplete_keywords

Claude

comparison_keywords

Claude

competitive_overview

Claude

domain_competitor_suggestions

Claude

domain_overview

Claude

domain_top_keywords

Claude

domain_top_pages

Claude

domain_traffic_history

Claude

generate_post

Claude

get_audit

Claude

get_audit_summary

Claude

get_keyword_metrics

Claude

get_location_by_code

Claude

get_month_view

Claude

get_post

Claude

get_project

Claude

get_publication

Claude

get_site_information

Claude

gsc_query_details

Claude

gsc_status

Claude

gsc_summary

Claude

gsc_top_pages

Claude

gsc_top_queries

Claude

gsc_trend

Claude

keyword_gap

Claude

list_audit_issues

Claude

list_audits_for_project

Claude

list_cities

Claude

list_competitors

Claude

list_countries

Claude

list_crawled_pages

Claude

list_domain_history

Claude

list_keyword_history

Claude

list_languages

Claude

list_posts

Claude

list_projects

Claude

list_publications

Claude

preposition_keywords

Claude

question_keywords

Claude

refill_queue

Claude

refresh_ideas

Claude

reject_post

Claude

replace_competitors

Claude

schedule_post

Claude

score_keyword

Claude

search_locations

Claude

start_site_audit

Claude

unschedule_post

Claude

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/vibeseo"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/vibeseo)