Skip to content
Docs

Keywords and content

The RankX AI MCP tools for keyword research, search trends, topic clusters, content briefs, and writing and approving articles. None of them publish.

These tools let an assistant take a topic from keyword research to a reviewed draft: discover keywords, check whether interest is rising, group them into topic clusters, write an article, and record a person's approval. Nothing in this group publishes to your website. Publishing is a separate step with its own tool and scope.

ToolScopeWhat it does
approve_content_itemwriteApproves a Content Studio article so it can be published, which is the human sign-off. Free, and it changes nothing on the website; an article quoting a named person is refused until that person has agreed to their words.
create_content_briefwriteCreates a content brief for a primary keyword and starts its background research, which spends credits. Generating an article from the brief is a separate step with its own price.
generate_articlespendGenerates a full article from a researched brief. Dispatch and poll: it returns a content item id immediately, and the draft is read back with get_content_item. It never publishes.
get_article_runreadFree. Reports how far a write_article run has got: researching, writing_queued (another article on this website is being written first), writing, ready, needs_edits, failed or not_started. Poll it until settled is true; when the stage is ready, read the draft with get_content_item.
get_content_briefreadOne content brief in full: primary and supporting keywords, reader questions, angle, outline and status.
get_content_itemreadOne Content Studio article in full, including the body text, meta fields, target keywords and quality scores. A null body means the article has not been drafted yet.
get_keyword_trendsspendSearch interest over time for up to five keywords, with momentum and related rising queries. Dispatch and poll, and a repeat within the cache window is free.
get_keyword_trends_statusreadPolls a trends analysis started by get_keyword_trends until it completes. Reading is always free.
link_keyword_to_clusterwriteAttaches an already-tracked keyword to a topic cluster. Attach only and idempotent, so a retry can never demote an existing link.
list_content_itemsreadContent Studio items with status, target keyword and quality scores. Null scores mean not yet computed rather than zero.
list_topic_clustersreadA Website's topic clusters with their linked counts. Clusters are the single grouping that keywords, tracked prompts and content all hang from.
research_keywordsspendDiscovers related keywords for up to twenty seed terms, with volume, cost per click, competition and trend. Repeating a recent search inside the cache window is free.
write_articlespendWrites a full article from a topic for one price by length, covering research, outline and writing, with no brief to create or approve first. Spends credits, so the caller confirms first. Dispatch and poll: it returns at once and the run is followed with get_article_run until settled. It never publishes.

The table above is generated from RankX AI itself rather than written by hand, as at 30 September 2026 (source b27dec96). When the product changes, this page changes with it.

A typical request to an assistant with these tools connected:

Write a standard-length article on 'how AI assistants choose sources'. Tell me the price first, then poll until it settles and show me the outline.

The workflow, in order

From a seed keyword to a published article
graph LR
  A[research_keywords] --> B[save_keywords]
  B --> C[link_keyword_to_cluster]
  C --> D[create_content_brief]
  D --> E[get_content_brief]
  E --> F[generate_article]
  F --> G[get_content_item]
  G --> H[A person reviews and approves]
  H --> I[publish_content_item]
  W[write_article] --> R[get_article_run]
  R --> G

Each arrow is a decision, not an automatic hand-off, and the writing steps take minutes rather than seconds. write_article is the short path: one call from a topic to a draft, with the research handled inside it.

research_keywords discovers related keywords for up to twenty seed terms, with search volume, cost per click, competition and trend. It runs in the Website's own market unless you name another, and it spends only on a fresh discovery: repeating a recent search inside the cache window is free.

research_keywords needs no status tool. If it reports that it is still running, call it again with the same seeds: the call is safe to retry and does not charge twice.

get_keyword_trends covers up to five keywords, and a fresh analysis runs in the background: it returns a task id, and you poll get_keyword_trends_status until the data is ready. A repeat inside the cache window returns the data at once, free. Related queries come back only for a single-keyword request.

Topic clusters

A topic cluster is RankX AI's single grouping for keywords, tracked prompts and content on one subject, so it joins the research side to the measurement side. list_topic_clusters reads a Website's clusters with their linked counts.

link_keyword_to_cluster attaches an already-tracked keyword to a cluster. It is attach-only and idempotent: an existing link is never changed, so a retry cannot undo one.

Clusters themselves are created in RankX AI, where the person who owns how the business describes itself makes that decision.

Content briefs

create_content_brief creates a brief for a primary keyword and starts its background research. Creating a brief spends credits, because that is when the research runs, and its own description carries the current price. Writing the article from the brief is a second, separately priced step, which is why write_article is the simpler choice when you have a topic and no brief.

Poll get_content_brief until the research completes. It returns the brief in full: primary and supporting keywords, the reader questions it should answer, the angle, the outline and the status.

The tools that create briefs and write articles need Content Studio on the account's plan. On a plan without it, they say so and name the upgrade instead of running.

Writing an article in one step

write_article writes a full article from a topic or keyword in one call. Research, outline and writing run in the background for one price by length (short, standard or long), with no brief to create or approve first. Its own description carries the current price for each length, and it needs the spend scope, so the assistant confirms the cost with you before calling it.

write_article returns at once, and get_article_run reports the stage: researching, writing, or writing queued (another article on the same Website is being written first, so keep polling). Stop when it reports settled, at ready, needs edits (a saved draft that needs edits and will not move on by itself), failed or not started. Once the run reports an item id, get_content_item reads the draft.

The price is reserved when the run starts and charged once the article is written. Nothing is charged when the research finds no citable sources, or when writing fails or never starts before a draft is saved. A run that stops after saving a draft for editing is charged for the share of the writing done.

Writing from a brief

generate_article writes the article from a brief you have already researched. It returns a content item id at once, writing runs in the background for a few minutes, and you poll get_content_item while the status is generating or in quality review. Ready for review or changes requested (a saved draft that needs edits) means there is a draft to read; archived, cancelled or failed means the run stopped.

Four things to know before calling it:

  • It needs a brief with completed research. A brief without usable research is refused before any credits are reserved, so a premature call costs nothing.
  • It approves a draft brief as part of the step. Confirming the generation is taken as approval of the brief it writes from.
  • Its price is tiered by length, and the tool's own description carries the current figure.
  • It does not publish. The draft lands in Content Studio for a person to review.

Approving a draft

approve_content_item records the sign-off an article needs before it can be published. It is free and changes nothing on the website. Only a draft that is ready for review, or has had changes requested, can be approved, and an article quoting a named person is refused until that person has agreed to their words.

Show the person the article with get_content_item first and approve only when they say so, because approval is the decision, not a formality. publish_content_item then puts it on the site, and it refuses an article nobody has approved.

Reading a draft back

list_content_items returns items with status, target keyword and quality scores. get_content_item returns one in full: the body as plain text, meta title and description, target keywords, quality and GEO scores, counts of fact-checked claims and internal links, and how many claims need review.

A null score means not yet computed, not zero. A null body means the article has not been drafted yet, which is what you see while writing is still running.

Example prompts

Research keywords around 'ai visibility tracking' and show me the ten with the best volume-to-competition ratio. Do not save anything yet.

Save the five keywords I just picked for tracking, then link them to my 'AI search' topic cluster.

Check the search trend for 'generative engine optimisation'. If it is still processing, wait and check again.

Create a content brief for 'how to appear in AI answers', then tell me when the research is done and summarise the outline.

Generate an article from brief X. Confirm the cost with me first, then poll until it is ready and show me the first three paragraphs.

Where to go next

Questions

Should I use write_article or generate_article?

Use write_article when you have a topic and want one call for one price, with research included. Use generate_article when you have already created and researched a brief with create_content_brief and want the article written from it.

Does writing an article publish it to my website?

No. Both writing tools save a draft in Content Studio. A person approves it with approve_content_item, and only publish_content_item puts it on a connected WordPress site, as described in WordPress and WooCommerce.

Is repeating a keyword search charged again?

No. research_keywords and get_keyword_trends charge only for a fresh analysis; repeating a recent search inside the cache window returns the stored result for free.

Last updated

Cookie settings

Choose which cookies we can use. You can change this at any time from “Cookie settings” in the footer.

Essential

Security, bot protection and remembering your choice. The site needs them to run, and they do not identify you. Always on.

Google Analytics cookies that tell us which pages are read and which links are followed, so we can improve them. Off until you switch it on.

Tells advertisers when their advert led to your visit. Includes the Meta (Facebook) pixel and the LinkedIn Insight Tag, which set cookies on this domain (LinkedIn also on linkedin.com) and can be told if you later start a trial.

More in the cookie policy and the privacy policy.