MCP App Store
by KeenEthics
SEO with RankSpot icon

SEO with RankSpot MCP Server for ChatGPT

By RankSpot

Overview

RankSpot is an SEO tool for website owners, marketers and agencies. It helps your site get more visitors from Google search and get mentioned in AI-generated answers. Connect your RankSpot account to work on your sites from the chat. What you can do: - Track the questions people ask AI assistants about your category, read the answers, see whether your brand is mentioned, and review which pages the answers cite. - Research competitors, manage and score your keyword list, and find the questions people ask on Google. - Read Google Search Console performance, check whether a page is indexed, and request indexing. - Plan SEO work as tasks, generate articles, edit them, restore earlier versions, and publish to your connected website (for example WordPress, Webflow, Shopify or Ghost). - Run live Google searches and read public pages for research. - Find the right contact on a site and send link-building emails from the mailbox you connected, then track replies and links won. Who it is for: anyone with a RankSpot workspace for a website they own or manage. Limitations: you need a RankSpot account and at least one workspace. Search Console tools need a connected Search Console property, publishing needs a connected website, and outreach needs a connected mailbox. Article generation and some research tools use your workspace's usage allowance. Publishing, sending email and deleting happen only when you ask, and deletes require explicit confirmation.

How to connect

  1. ChatGPT: Open the SEO with RankSpot listing in the ChatGPT app directory and choose Connect. ChatGPT listing SEO with RankSpot exposes 71 tools here.

Tools

rankspot_add_ai_prompt

ChatGPT
Start tracking a question against the AI platforms. Call this when the user wants to monitor how AI answers a specific question about their category. Phrase it as a real user would ask it ("best crm for small business"), not as a keyword. Results are NOT available immediately: prompts run on a daily schedule, so the first answers appear after the next run. Resubmitting a prompt that was archived restores it. Plans cap how many prompts can be tracked at once; at the limit this returns ai-prompt-limit-exceeded, which means archive one rather than retry.

rankspot_add_competitor

ChatGPT
Start tracking a competitor domain. This is also how you act on a track_competitor action: pass the domain from rankspot_list_competitors scope="discovered" and the brand is promoted to tracked, keeping the mentions already attributed to it. Their keywords and backlinks are then discovered on a background sync that runs roughly every 1–2 weeks, so results are NOT available immediately after this call — set that expectation with the user rather than polling. Workspaces have a competitor limit (3 by default) and this fails once that limit is reached, or if the domain is already tracked.

rankspot_add_keywords

ChatGPT
Add one or more keywords to track in this workspace. Call this when the user wants to start tracking specific search terms. Duplicates are silently skipped. Enrichment (search volume, competition, AI scores) happens on a background job, so the numbers are NOT available immediately after this call — list keywords later to read them. Returns the count of newly inserted keywords.

rankspot_ai_visibility_summary

ChatGPT
The headline picture of how AI answer engines see this brand over a period: overall visibility, the score per platform (ChatGPT, Perplexity, Google AI Overview, Google AI Mode), share of voice, citation share, and the ten most-mentioned brands with this workspace's own always included. Start here for almost any question about AI visibility, AI search, LLM mentions or competitors in AI answers — it answers "how am I doing", "on which platform" and "versus whom" in one call. startDate and endDate are REQUIRED. To judge a trend, call it twice with two periods of EQUAL LENGTH and compare; unequal periods measure the calendar rather than the brand. A null score means the period had no data, which is not the same as zero — read responsesCounted before quoting any figure, because 100% across two answers is not the claim 100% across two hundred is. Use rankspot_list_ai_responses instead when the user wants the actual wording of an answer.

rankspot_archive_ai_citation

ChatGPT
Archive a cited page so it drops out of the default list. Use it to declutter irrelevant sources, not to remove data: the page keeps counting towards citation share, because archiving is a statement about the workflow and not about what the engines cited. Reversible.

rankspot_archive_ai_fanout_query

ChatGPT
Archive a fanout query so it drops out of every non-archived list. This is the only way to retire a search by hand, since the rest of its state follows the actions and articles linked to it. Use it to declutter navigational or irrelevant searches, not to remove data: it keeps counting towards the reporting, because archiving is a statement about the workflow and not about what the engines ran. Reversible.

rankspot_archive_ai_prompt

ChatGPT
Archive a prompt so it stops being run and frees an allowance slot. The run history is kept, so past scores stay intact — this is why prompts are archived and never deleted. Reversible with rankspot_unarchive_ai_prompt.

rankspot_archive_keyword

ChatGPT
Soft-delete (archive) a keyword. It is excluded from the default list but recoverable via rankspot_unarchive_keyword or by listing with type=archived. Use this to declutter, not to permanently remove data.

rankspot_archive_people_also_ask

ChatGPT
Soft-delete (archive) a "People also ask" question so it no longer appears in the list. Recoverable — this is not a permanent delete.

rankspot_create_action

ChatGPT
Create a new action. type is required and has no default, and it decides which other fields apply: - write_article — plan a piece of content, then call POST /v1/actions/:id/generate to write it. Requires no target. - update_article — any edit to an existing article, with the instruction in additionalInstructions. Requires articleId. - earn_link — go after a referring domain your competitors have. Requires backlinkId. - get_cited — get onto a page AI engines already cite. Requires citationId. - reply_thread — reply on a cited Reddit or Quora thread. Requires citationId. - record_video — make a video of your own, since you cannot be added to someone else's. Requires citationId. - track_competitor — start tracking a brand RankSpot discovered in AI answers. Requires competitorId. - add_prompt — track a question buyers ask that no existing prompt covers. Requires no target. - publish_article — push a finished article to the workspace integrations. Requires articleId. - request_indexing — ask Google to index a published page it has missed. Requires articleId. - other — anything you just want written down. Requires no target. For write_article, call rankspot_generate_article afterwards to write it. For update_article put the actual instruction in additionalInstructions ("add internal links", "the pricing section is out of date"). write_article, update_article and add_prompt also take an optional fanoutQueryIds: the searches engines keep running that make the work worth doing. That is provenance, not a target, so pass keywordIds alongside it. For write_article, linking tracked keywords via keywordIds (UUIDs from rankspot_list_keywords) broadens the article's semantic coverage — a good pattern is a strong "new" keyword plus its rankspot_get_keyword_cluster results. Titles must be unique per workspace. Always set shortDescription: it is the line under the title in the list and usually the only text the user reads. Put the fuller reasoning in description.

rankspot_create_category

ChatGPT
Create a new category for organising actions and articles. Names must be unique within the workspace. A default color is assigned automatically.

rankspot_create_outreach

ChatGPT
Creates an outreach opportunity with emails YOU write, and schedules them to go out from the workspace's mailboxes. Show the user the emails and get their go-ahead before calling: these are real emails to real people. The first waits at least an hour (it can be edited or deleted until it is sent), then goes out at the next free slot: 10 a day per mailbox, every day 8:00 to 20:00 US Central. Follow-ups go 3 and 7 days later unless someone replies. Rules, checked on every email: no links or domain names anywhere; greet with {{first_name}} rather than a typed name; the first email must sign off with {{sender_name}} or {{sender_first_name}} (the mailbox is picked when it sends). A 400 lists every problem at once. Refuses an address already contacted, and a site already contacted unless allowContactedSite is true (another author at the same publisher), and 409s with outreach-no-mailbox until a mailbox is connected in the RankSpot dashboard. Check capacity with rankspot_list_mailboxes before queueing a lot.

rankspot_delete_action

ChatGPT
Permanently delete an action. This is a HARD DELETE and cannot be undone. If an article was generated from it, the article is preserved and only the link is removed. Requires confirm: true, and only set that after the user has explicitly confirmed deleting this specific action.

rankspot_delete_article

ChatGPT
Permanently delete an article. This is a HARD DELETE and cannot be undone. Associated action and keyword links are preserved. Requires confirm: true — only set it after the user has explicitly confirmed deleting this specific article.

rankspot_delete_category

ChatGPT
Permanently delete a category. This is a HARD DELETE and cannot be undone. Actions and articles assigned to it have their category cleared (not deleted). Requires confirm: true — only set it after the user has explicitly confirmed deleting this specific category.

rankspot_delete_competitor

ChatGPT
Stop tracking a competitor and remove it from every list. The AI answers already attributed to the brand are kept, so past visibility scores are unchanged, and rankspot_add_competitor on the same domain restores it. Discovered keywords and backlinks are preserved but their competitor link is cleared. Requires confirm: true — only set it after the user has explicitly confirmed removing this specific competitor.

rankspot_delete_outreach

ChatGPT
Permanently deletes an opportunity nothing was sent from yet. Once a conversation started, use rankspot_stop_outreach instead.

rankspot_fetch_page

ChatGPT
Fetch one public URL and read it. Returns the page as markdown and nothing else. A second provider is tried automatically when the first cannot read the page, and a page that nothing could read is an error rather than an empty string. THIS COSTS THE USER CREDITS per page. Use it to settle a specific question a listing cannot answer: does this directory accept submissions, does this roundup already mention us, is this thread still active. Never crawl a site page by page — if you want several pages from one domain, fetch the one that decides the answer.

rankspot_find_contact

ChatGPT
Reads a page, works out who wrote it, and finds and checks their email. Returns the author and up to 5 addresses best first, each with deliverability (valid, risky = the domain accepts everything, unknown, not_checked) and confidence. Email the first; pass the rest as backups in contactEmails. THIS COSTS THE USER CREDITS (about 10 to 40 per page) and can take a minute. Before paying for a lookup, check the site was not already contacted with rankspot_list_outreach and domain. If you already know the person, rankspot_find_email is cheaper.

rankspot_find_email

ChatGPT
Finds and checks the address of a known person at a domain. email is null when nothing deliverable was found. COSTS CREDITS, fewer than rankspot_find_contact since no page is read.

rankspot_generate_article

ChatGPT
Trigger AI article generation. ALWAYS give the user the returned url as a link: it opens the article in RankSpot, where they can watch it being researched and written live. The action must be type "write_article" with status "new"; any other type returns an error. Generation is ASYNCHRONOUS and takes about 5-10 minutes. The article is created up front with status "generating", so this returns { success, articleId, slug, url } immediately. Poll rankspot_get_action until its status is "processed" to know it is finished. Respects the plan's article generation limit and fails if it is exceeded.

rankspot_get_action

ChatGPT
Get a single action by UUID, including its type, status, linked keywords and the ID of the generated article if one exists. Call this to inspect an action before updating it or generating an article for it.

rankspot_get_ai_fanout_query_cluster

ChatGPT
The searches that mean the same thing as this one, most-run first, with the seed leading. Engines phrase one intent many ways, so an action should carry the cluster rather than whichever phrasing you happened to pick: pass the ids straight to rankspot_create_action as fanoutQueryIds. Takes the search UUID from rankspot_list_ai_fanout_queries. Returns just the seed when nothing else is close.

rankspot_get_ai_response

ChatGPT
The full text of a single captured answer as markdown, the pages it cited in the order it cited them, the searches the platform ran while composing it, and every brand it named with position and sentiment. Call this to quote or analyse what an engine actually said. Takes the response UUID from rankspot_list_ai_responses.

rankspot_get_article

ChatGPT
Get a single article by UUID with its body as Markdown (contentMarkdown). Call this when the user wants to read, review, or edit a specific article's body, and always right before editing it with rankspot_update_article, so the edit starts from the current text.

rankspot_get_keyword_cluster

ChatGPT
Return keywords semantically similar to a given seed keyword, for grouping related terms under a single content topic. Call this when planning content and you want the cluster around one keyword. Takes the keyword UUID (from rankspot_list_keywords), not the text. Returns an empty array if the seed has not been semantically indexed yet.

rankspot_get_outreach

ChatGPT
One opportunity: the emails as written (sequence, each with its status and not-before time) and everything exchanged so far (thread, oldest first; a reply's body has the quoted earlier emails removed).

rankspot_get_workspace

ChatGPT
Brand and business context for this workspace: brand name, domain, what the business does, who it sells to, tone of voice, industry, and the country and language it targets. Call this FIRST when deciding what SEO work is worth doing. Every other tool returns data that only means something in context: whether a keyword is relevant, whether a cited page is worth pitching, whether a competitor actually competes. Without this you are guessing at what the business is. domain also tells you which citations and backlinks are already your own, but it is stored as the user typed it, so it may be a bare hostname or a full URL — strip the scheme and any trailing slash before comparing it with the bare hostnames every other tool returns. Any field can be null if onboarding was skipped. Read-only.

rankspot_gsc_inspect_url

ChatGPT
Inspect a single URL with Google Search Console and report its index status. Call this when the user asks whether a page is indexed or why it is not. The page is indexed when indexStatusResult.verdict is PASS; otherwise read coverageState for the reason. Requires GSC connected. The URL must belong to the connected property.

rankspot_gsc_performance

ChatGPT
Get clicks, impressions, CTR, and average position from Google Search Console for the connected property. Call this when the user asks how their pages or queries are performing in Google Search. Requires GSC to be connected from the RankSpot dashboard — fails otherwise. Group by up to 3 dimensions. Dates are YYYY-MM-DD; data lags ~2-3 days and covers at most the last 16 months.

rankspot_gsc_request_indexing

ChatGPT
Notify Google via the Indexing API that a URL was added/updated (URL_UPDATED) or removed (URL_DELETED). Call this after publishing or updating a page. Requires a GSC connection with the indexing scope where the account is a verified owner. Success means Google received the notification — it does not guarantee indexing; use rankspot_gsc_inspect_url afterwards to check status.

rankspot_list_actions

ChatGPT
List the SEO work planned in this workspace. An action is one thing to do, and type says what kind. Call this when the user asks what is planned, in progress or already done. Pass types=["write_article"] when they ask specifically about content, and leave types off to see everything. Status: new (not started), in_progress (running now), processed (finished). Dismissed actions are never returned.

rankspot_list_ai_citations

ChatGPT
The pages AI engines cited while answering the tracked prompts, most-cited first. This is the link-building and content worklist for AI search: the sites the engines trust on these questions. Defaults to pages not yet acted on. Use the domain filter (substring, case-insensitive) to check one site, including this workspace's own. Covers the whole history unless narrowed by date, and the citation count is scoped to whatever period is asked for.

rankspot_list_ai_fanout_queries

ChatGPT
The searches AI engines ran while answering the tracked prompts, most-run first. Where a citation says which page an engine trusted, a fanout query says what it decided it needed to know — so a query that comes up often and has no content behind it is a gap stated in the engine's own words, and one of the strongest signals here for what to write next. Feed a promising one into rankspot_create_action as fanoutQueryIds. State is derived from the work linked to the query rather than stored, so it moves on its own as actions and articles appear. Defaults to queries with nothing planned or written for them. Covers the whole history unless narrowed by date; a date range lists only the queries engines ran inside it, and scopes the search count to it as well.

rankspot_list_ai_prompts

ChatGPT
List the questions RankSpot asks the AI platforms on every run. Call this when the user asks what they are tracking in AI search, or before adding a prompt so you do not duplicate one. Returns the prompts only, with no scores — use rankspot_ai_visibility_summary for how the brand is performing.

rankspot_list_ai_responses

ChatGPT
The answers the AI platforms actually gave to the tracked prompts, newest first, each with whether it named this brand and which brands it did name. Call this when the user asks what ChatGPT/Perplexity/Google said, or which prompts they are invisible on (mentioned=false). Covers the whole history unless narrowed by date. Runs that failed are never returned, so an absent answer is never a miss. Returns metadata only — call rankspot_get_ai_response with a row id for the answer text itself.

rankspot_list_article_revisions

ChatGPT
The last 10 revisions of an article, newest first; the first is the article as it is now. Each is one editing session (source: editor, api, generation, restore, baseline). live marks what was last published. Use it to find the version to go back to with rankspot_restore_article_revision.

rankspot_list_articles

ChatGPT
List AI-generated articles in this workspace. Call this when the user asks what articles exist or their status. The body is omitted here to keep payloads small — use rankspot_get_article to read a single article's body. Two filters matter when planning work: search answers "do we already cover this?", and slug turns a published URL back into an article. firstPublishedAt is when the article went live and stays put on a re-publish, so it is the publication date; lastPublishedAt is when the content last reached readers, which is the field to check for staleness — updatedAt moves on any write at all. Every row also carries its Google index state: isIndexed, indexCoverageState (Search Console's own reason when it is not), indexCheckedAt and indexRequestedAt. Filter with indexed: false rather than reading them all back.

rankspot_list_categories

ChatGPT
List categories used to organise actions and articles. Call this when you need a categoryId to assign to an action or article, or when the user asks how their content is organised.

rankspot_list_competitors

ChatGPT
List competitor brands in this workspace. Defaults to the tracked ones. Pass scope="discovered" for brands RankSpot found in AI answers but is not tracking yet, which is what a "should we track this?" decision needs, or scope="all" for both. Each row carries isTracked, autoDiscovered and mentionCount, so you can tell them apart and rank them.

rankspot_list_keywords

ChatGPT
List SEO keywords tracked in this RankSpot workspace, with search volume, competition, and AI relevance scores. Call this when the user asks which keywords they track, wants to pick keywords to target, or asks about volume or difficulty for keywords they already have. To find content opportunities — keywords worth writing about that have no content yet — use type="new" with sortBy="compositeScore" (the best single priority signal, blending opportunity and AI relevance). Do not call it to discover brand-new keywords for a domain that is not tracked yet. Trial workspaces can only read the first 20 results, so leave offset at 0 unless you know the plan is active.

rankspot_list_mailboxes

ChatGPT
Each connected mailbox with what it sent today and how many emails are bound to it (queued, mostly follow-ups; a first email is bound once a mailbox picks it). Each mailbox sends 10 automated emails per day, so check this before queueing a lot of outreach. Mailboxes are connected in the RankSpot dashboard, not here.

rankspot_list_outreach

ChatGPT
Outreach conversations, newest activity first. Use it to check whether a site or person was already contacted (domain, email) before finding contacts or pitching, and to see what is new: needsReply: true lists replies waiting on the user, since anything that moved after a time. status: scheduled (nothing sent yet, still editable), sent (no reply yet), replied, processed. pending: true lists everything with an email still to go out, soonest first. Read a thread with rankspot_get_outreach.

rankspot_list_people_also_ask

ChatGPT
List "People also ask" questions discovered from search results for tracked keywords. These are real search queries — use them as FAQ sections in articles to capture featured-snippet positions. Call this when planning FAQ content or looking for question-shaped content ideas. They are auto-populated by RankSpot and cannot be created via the API. Filter by status to separate new from already-processed questions.

rankspot_list_workspaces

ChatGPT
List the workspaces this connection can reach, each with its organization, brand, domain and business context. A workspace is one site or brand; the user may belong to several organizations, such as their own and a client's. When the other tools ask for a workspace_id, call this first and pick the workspace the user means; ask them if it is unclear. A connection made for one workspace lists just that one. Read-only.

rankspot_outreach_stats

ChatGPT
Outreach numbers for a period: emails sent (first emails and each follow-up), replies from people, automatic replies, bounces, reply rate (of the sites first emailed in the period, how many answered), bounce rate, which email in the sequence the replies answered, median hours to a reply, and per-day counts. Use it to answer "how is outreach going" or to compare periods. Days are US Central; the default is the last 30 days.

rankspot_process_outreach

ChatGPT
Marks it processed, whatever came of it: anything waiting is cancelled and it becomes read-only. A late reply is still recorded.

rankspot_publish_article

ChatGPT
Push the article as it is now to one of the workspace's connected integrations, exactly like the Publish button in the editor: published for the first time, or updated in place when it is already there. This makes the content public, so only call it when the user asked to publish.

rankspot_reply_outreach

ChatGPT
Sends a reply right away from the conversation's mailbox to whoever wrote last, threaded under the exchange, and cancels follow-ups still waiting. It is a real email: show the user what you will send and get their go-ahead first. Plain text; links are fine here, unlike in the automated emails.

rankspot_restore_article_revision

ChatGPT
Write an older revision's title, description and body back onto the article. The current version stays in the history, so this can be undone the same way. Nothing is published.

rankspot_search_google

ChatGPT
Run a live Google search and get back the top 10 as items, the blocks of the results page in page order. Read type on each item and branch on it. By default you get the organic results and discussions_and_forums; pass types to ask for ai_overview, people_also_ask, video or related_searches as well, but only when you will read them — one ai_overview block can be longer than every organic result together. THIS COSTS THE USER CREDITS, so use it when the answer changes what you do — who already ranks for a query before you propose an article, what a title has to beat — and not to confirm something the RankSpot tools already told you. Location and language come from the workspace, so results match the rest of RankSpot; you cannot and need not set them.

rankspot_stop_outreach

ChatGPT
Cancels every scheduled email of a conversation. The thread and any replies stay.

rankspot_unarchive_ai_citation

ChatGPT
Put a previously archived cited page back on the worklist so it appears in the default list again.

rankspot_unarchive_ai_fanout_query

ChatGPT
Put a previously archived fanout query back on the worklist so it appears in the default list again.

rankspot_unarchive_ai_prompt

ChatGPT
Put an archived prompt back into the daily run. It takes an allowance slot again, so it is refused with ai-prompt-limit-exceeded when the plan is full.

rankspot_unarchive_keyword

ChatGPT
Restore a previously archived keyword so it appears in the default list again.

rankspot_update_action

ChatGPT
Update an action's status, archive it, or edit its title, description, instructions, category or linked keywords. Passing keywordIds replaces the full set of linked keywords. Content can only be edited while the action is "new": once an executor has started, it is locked and editing returns an error. Status can be set on anything that is not currently being generated, so work done outside RankSpot can be closed off here; archived can be set at any time.

rankspot_update_ai_citation_status

ChatGPT
Track which citation opportunities have been acted on. Set processed once the page has been dealt with (outreach sent, content written), or back to new to requeue it. This is workflow state only — it does not change what the engines cited or any score.

rankspot_update_ai_prompt

ChatGPT
Change the wording of a tracked prompt, keeping its history: it is the same tracked question, reworded. Use this to fix a typo or sharpen the phrasing. For a genuinely different question add a new prompt instead, or the history will span two questions and the trend will be meaningless.

rankspot_update_article

ChatGPT
Edit an article's body and/or metadata (title, description, slug, cover image, category). To edit the body: call rankspot_get_article, edit its contentMarkdown, and send the WHOLE article back as contentMarkdown. Never send only the changed part or write "rest unchanged": whatever is missing is deleted. You can add, remove, reorder or rewrite sections. Keep lines of HTML (videos and similar) exactly as they are. Links are [text](url); internal links are dofollow and external ones nofollow automatically. Only when the user asks for a dofollow external link, write <a href="https://example.com" rel="dofollow">anchor</a> (rel="nofollow" does the reverse for an internal link). Always pass a sessionId: pick one at the start of the conversation and reuse it on every write in that conversation, so the history shows it as one revision. Every write is kept in the revision history (rankspot_list_article_revisions) and can be undone with rankspot_restore_article_revision. Nothing goes live until rankspot_publish_article. The slug must be unique within the workspace.

rankspot_update_category

ChatGPT
Rename a category. The new name must be unique within the workspace.

rankspot_update_outreach

ChatGPT
Changes any of the fields until the first email is sent (status scheduled). sequence replaces the whole list. The send time stays as it was. Refused (409) once the first email went out.

rankspot_update_people_also_ask

ChatGPT
Update the status of a "People also ask" question. Mark "processed" once addressed (e.g. added as an FAQ), or "new" to reconsider it.

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/seo-with-rankspot"><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/seo-with-rankspot)