Skip to main content

Which MCP tools does TalkGenAI offer?

The TalkGenAI MCP server at https://app.talkgen.ai/mcp has 19 tools for the Marketing Brain, planning, writing, publishing and measuring articles, and for refreshing pages that are already on your WordPress site. It is a stateless Streamable HTTP server. Claude.ai and Claude Code sign in with OAuth, and other clients send an agent key in the Authorization: Bearer tgai_... header. Either way the connection is an agent key underneath, and a tool only appears if that key has a scope that allows it.

Which tools exist and what do they cost?

How does an agent write and publish an article?

  1. get_company_brain for the business context and the brand voice id, and list_sites for a connection_id.
  2. get_content_plan to find an open card, or choose a title. With no plan, create_content_plan once the user agrees to the 20 credits.
  3. generate_article with plan_id and card_index, or with title.
  4. get_article every 5 to 10 seconds until status is completed.
  5. publish_article with job_id and connection_id. This saves a draft.
To change an article that is already published: refine_article, poll get_article until refine.status is done, then update_live_post. Use list_articles to find an article from an earlier session.

How does an agent refresh an old page?

This works for any page on a connected WordPress site, including pages TalkGenAI did not write.
  1. get_rankings with sort set to low_traffic to find pages Google shows but people rarely click.
  2. inspect_page with the page URL. Stop if safe_to_replace is false and pass the message to the user.
  3. refresh_page without image first. It returns the image question for this page and charges nothing. Ask the user, then call again with image true or false.
  4. get_article until status is completed. Show the user the new version.
  5. replace_live_page without confirm_overwrite. It returns the exact question to ask. Call again with confirm_overwrite: true only after the user says yes.

Content tools

generate_article

Writes a complete article. Generation runs in the background and takes 45 to 360 seconds depending on length. It does not publish anything.

get_article

Returns status (pending, processing, completed, failed) and progress. When completed it also returns html, seo_title, meta_description, focus_keyword, word_count and has_image. Poll every 5 to 10 seconds. Read endpoints are limited to about 60 requests a minute per key.

publish_article

See Publish safely.

get_content_plan

Free. Scheduling and autopilot stay in the dashboard.

get_company_brain and update_business_context

get_company_brain takes an optional domain and returns the Marketing Brain for that site: business_context (with source and safe_for_generation), brand_voice (the voice in force, every saved voice and the system voices, each with an id to pass as brand_voice_id, plus mismatch when the voice was learned from a different site), brand_image styles and website. update_business_context takes business_context (the full new text, up to 900 characters) and an optional domain. With domain it is saved for that site, without it for the whole account. It replaces the current text. An empty text is refused unless clear is true. Viewers cannot edit it. Brand voice and brand image are trained in the dashboard.

create_content_plan

Costs 20 credits (the first plan is free on Starter) and needs a paid plan. Some tiers get one plan only, so the agent should ask the user first. Returns a plan_id at once; poll get_content_plan with it every 30 to 60 seconds. If a plan for the same site is already being built, that one is returned and nothing is charged.

update_plan_card

A published card can be skipped (the post stays live) but not edited. Scheduled and generating cards can only be changed in the dashboard.

list_articles

refine_article and update_live_post

refine_article takes job_id and instruction (for example “shorten the intro and add a pricing section”). It costs 2 credits on paid plans, keeps the brand voice, and runs in the background. get_article then returns a refine object; when its status is done the article HTML is the new version. A failed refine is refunded. One refine runs at a time per article. update_live_post takes job_id and pushes the current title and text into the post the article is already on. The post keeps its URL and status. Use it instead of publish_article for an article that is already published.

get_report

Returns the same numbers as the dashboard’s Measure tab, with the same plan limits. Reports that need Google Analytics or Search Console return a message saying so when they are not connected. Long lists are cut to 25 rows.

get_rankings

| sort | enum | clicks (default) or low_traffic, which adds low_traffic_pages: pages with impressions and few clicks, fewest clicks first | | min_impressions | integer | With low_traffic: only pages shown at least this often in the last 28 days. Default 20 | | limit | integer | With low_traffic: 1 to 50 pages. Default 20 | Returns an upgrade message on Free and Starter plans.

Page refresh tools

Refresh replaces a page that is already live on a WordPress site, at the same URL. It needs the TalkGenAI plugin 2.7.12 or later. Pages built with a page builder (Elementor, Divi, WPBakery and others), pages with forms, shortcodes or designed layouts, and the home page are refused: inspect_page says why.

inspect_page

Returns the title, word count, Search Console numbers for the last 28 days, the current SEO title and description, the plain text, warnings and safe_to_replace. Read-only.

refresh_page

Keeps the page’s subject, language and business facts (prices, addresses, names), keeps its own internal links, and does not add new numbers. Runs in the background: poll get_article.

replace_live_page

Replaces the title, text, SEO title and meta description. The URL stays the same. Returns the next steps for the user: clear the cache and request indexing in Search Console. Returns 403 live_publish_disabled if the workspace blocked live publishing by agents.

update_page_seo_meta

Takes url, seo_title (about 60 characters), meta_description (about 155) and confirm_overwrite. Changes only those two fields, so it also works on page-builder pages. Needs Yoast, Rank Math, All in One SEO or SEOPress.

Which REST endpoints match the tools?

Last updated: 2026-11-08