Agility Writer MCP server
Yes. Agility Writer publishes an official MCP server at https://mcp.agilitywriter.ai/mcp. It's hosted. It offers 28 tools. We last checked it on 22 Nov 2026.
Official: answers MCP requests at mcp.agilitywriter.ai, on Agility Writer's own domain agilitywriter.ai. Checked 22 Nov 2026. Maintained by Stuart Brameld.
Key facts
As of 22 Nov 2026, Agility Writer's official MCP server scores 55/100 (provisional) on MartechDB's Agent Readiness Index (v1.1). It answered 56 of our 56 checks in the last 90 days and lists 28 tools.
How the Agent Readiness Index works · Wrong? Suggest a correction
Agility Writer MCP server review
55/100
Agility Writer's MCP server scores 55/100 on MartechDB's Agent Readiness Index: usable by AI agents, with gaps.
The good
Hosted by Agility Writer: connect by URL, with nothing to install
Answered 100% of our checks in the last 90 days
The bad
Needs a paid plan, with no free trial
Not checked yet: how you sign in; a docs page listing its tools. Anything not checked scores nothing.
Official MCP server
Agility Writer MCP server
- Address
- https://mcp.agilitywriter.ai/mcp
- Runs
- Hosted
- Sign-in
- Cost to use
- Plan: Every paid plan, including Basic · No free access
- Official MCP Registry
- Not listed
- How we know it's official
-
- Answers MCP requests at mcp.agilitywriter.ai, on Agility Writer's own domain agilitywriter.ai.
- Tools
- 28 tools · listed 22 Nov 2026
- First seen
- 1 Oct 2026
- Last checked
-
Reachable ·
16 Nov 2026: reachable17 Nov 2026: reachable18 Nov 2026: reachable19 Nov 2026: reachable20 Nov 2026: reachable21 Nov 2026: reachable22 Nov 2026: reachable
- Uptime
- 100% · 56 of 56 checks reachable since 1 Oct 2026
Agility Writer MCP server tools (28)
As the server lists them. Names and descriptions are the vendor's own.
-
create_articleCreate a research-grounded SEO article. This is not a single writing pass: AgilityWriter runs live SERP research for the keyword, reads the top-ranking pages, captures Google's AI Overview and the sources it cites, derives entity coverage from what competitors actually rank for, then writes the article section by section, filtering out facts it has already used and adding citations from the research it fetched. Prefer this over writing the article yourself when the goal is search or AI-answer visibility. For a quick draft, a snippet, or non-SEO writing, just write it directly instead - this costs real money and takes minutes. Cost and timing: 2 credits (3-5 with a premium ai_model) and typically 3-10 minutes. Call check_credits first if the balance might be short. ASYNCHRONOUS: returns an article_id immediately. Do NOT call get_article right away - wait about a minute, then poll get_article_status every 60 seconds (faster polling does not speed anything up) until article_status is "Co…
-
create_outlineGenerate an SEO article outline from live SERP research: the headings are derived from what the top-ranking pages actually cover, not invented from the model's own priors. It returns THREE alternative outlines. This is the Smart Writer flow, and the recommended first step for any article the user has not fully specified: review the variants yourself, pick the strongest (or merge their best sections, keeping headings unique), then pass the winner to create_article as article_outline VERBATIM - the "1. " numbers and "- " dashes are system syntax for H2/H3, never strip them; renumber sequentially if you merge. Also useful when the user wants to review the structure before committing credits, or as a research loop - take the outline, research each heading, then add per-heading notes in article_outline_powerup. Costs 1 AW Token (the monthly premium-tool allowance, a different pool from article credits - see check_credits). Do not call it speculatively. ASYNCHRONOUS: returns a job_id immedi…
-
get_outline_statusCheck an outline job started by create_outline, and fetch the outlines once it is done. Poll about every 30 seconds. The status field is the JOB state: "pending" or "processing" mean keep waiting; "success" means all_outlines holds all three generated variants (outline duplicates the first; keep their "1. "/"- " prefixes intact); "failed" means it will not finish and the AW Token was refunded. These are the same words polish jobs use, NOT the "Complete" that get_article_status uses. After about 10 minutes, stop polling and tell the user to ask again later.
-
rewrite_from_urlTurn an existing web page or YouTube video into a new article (YouTube URLs are detected automatically). AgilityWriter fetches the source itself, so you do not need to read the page first. Use this when the user points at a URL and wants their own article from it. To improve content the user already HAS in the conversation, use polish_article instead - it is cheaper and keeps their text. Costs 2 credits (3-5 with a premium ai_model) and takes 3-10 minutes. ASYNCHRONOUS: returns an article_id immediately; poll get_article_status about every 60 seconds until "Complete", then call get_article. Failures show as article_status "Failed (Refunded)" with credits returned. After ~10 minutes, stop polling and tell the user to check back later.
-
get_article_statusCheck article generation progress. Returns article_status and article_progress (0-100; 0 means still QUEUED, not yet writing). Free. Poll about every 60 seconds after create_article, create_webpage, or rewrite_from_url, and only call get_article once article_status is exactly "Complete". A status beginning "Failed (Refunded)" means generation failed and the credits were automatically returned - tell the user what happened instead of retrying silently. A long queue is NOT a failure: if progress stays at 0 or ~10 minutes pass, stop polling and tell the user the article keeps generating - they can ask again later or watch it in the AgilityWriter dashboard.
-
get_articleFetch a finished article: full HTML content, meta title, meta description, and featured image URL. Free. Also returns social media posts (Facebook, X, LinkedIn, Instagram and more), but only when the article was created with shoutout_posts enabled - otherwise those fields come back empty. Only call this once get_article_status reports "Complete"; before that the content is empty or partial.
-
list_projectsList the user's AgilityWriter projects (id, name, active status). create_article accepts a project_name directly, so this is mainly for showing the user their projects or finding the exact name when a mention does not match.
-
get_project_settingsRead one project's saved settings - tone, audience, language, region, business info, writing style, readability, negative terms, internal links, and a per-heading powerup_template when set - translated to this connector's parameter names. Free and read-only. create_article and create_webpage apply these automatically when given a project, so call this to show the user what will apply, or to use powerup_template, which is NEVER applied automatically: adapt it to the article's actual outline and pass it as article_outline_powerup. A project may also carry a publish destination (publish_to): articles written under it post themselves to that WordPress site when they finish.
-
list_sitesList the user's connected WordPress sites - the only valid publish_to destinations. Free and read-only. Sites are connected by installing the AgilityWriter WordPress plugin, never from here; an empty list means publishing is not set up yet.
-
create_webpageWrite a business or service PAGE (not a blog article): a landing page, service page, or location page for a specific business. Use this instead of create_article when the goal is a page about what a business offers rather than an informational article. Research is fixed to general web search, and the writer is told not to open with the business name and not to mention competitors. Asynchronous: returns an article_id immediately; poll get_article_status until "Complete", then call get_article. Costs 2 credits (3-5 with a premium model, which this tool leaves at the default). Deliberately a short parameter set: everything not listed uses AgilityWriter's defaults, except that a given project's saved settings (business info, tone, language, and more) fill in what you omit.
-
polish_articleImprove EXISTING content that you already have: rewrites it with live web-search-grounded fact enrichment, readability targeting, tone and point-of-view conforming, and banned-word removal. Accepts any pasted HTML or markdown - it does NOT have to be an AgilityWriter article, so this is the right tool for content the user brings to the conversation. Costs 1 credit, cheaper than generating an article from scratch. Asynchronous: returns a job_id immediately. Poll get_polish_status about every 60 seconds. IMPORTANT: polish jobs use a DIFFERENT vocabulary from articles - the terminal states are "success" and "failed", not "Complete". Give up after about 15 minutes and report the status to the user rather than polling forever. Prefer this over rewriting the content yourself when the user wants it fact-enriched from live sources; for a quick tone tweak, just edit it directly.
-
get_polish_statusCheck a polish job started by polish_article, and fetch the polished content once it is done. Poll about every 60 seconds. The status field is the JOB state: "pending" or "processing" mean keep waiting; "success" means the polished_content field is populated; "failed" means it will not finish and the credit was refunded. These are not the same words get_article_status uses. After about 15 minutes, stop polling and tell the user to ask again later.
-
list_articlesBrowse the user's existing AgilityWriter library. Free and read-only. Use it to answer questions about work they already have ("what did I write last week?", "which articles are still generating?", "find my article about X"), and to recover an article_id you no longer have so you can call get_article on it. Returns newest first with total/limit/offset for paging; archived articles are excluded unless include_archived is set. Covers everything in the account, not only articles created through this connector.
-
get_article_researchShow the evidence behind a generated article: the competitor pages AgilityWriter actually read (URL, title, extracted headings, word count, SERP position), the entity/keyword set the article was written to cover, and the harvested factual data. Free and read-only. Use it to show the user WHY an article says what it says, to cite the underlying sources, to check topic coverage against what competitors rank for, or to reuse those facts in follow-up work. Call it after an article completes. Older articles, rewrites, and failed generations may return an empty harvested_facts or no sources - that is expected, report what came back rather than treating it as an error.
-
save_projectCreate or update a project: the saved defaults (business facts, tone, audience, style, model, images, publish site) that create_article and create_webpage apply when given the project, and the web app uses too. Free. No project_id = create (name required; a name already in use returns an error with its project_id: update that one instead). With project_id = update: send ONLY the fields you are changing; omitted fields stay as they are and "" clears one. Values copied from get_project_settings are accepted; if its writing_style is not in the writing_style list here, omit writing_style. Live publishing is switched on by the user in the web app, never here (a new project publishes drafts). Returns the saved settings.
-
list_fact_sheetsList the user's saved fact sheets, newest first: id, title, type, status, website. Free. Fact sheets are business, product or service facts kept in AgilityWriter for every article. Look here before generating a new one; read one with get_fact_sheet.
-
get_fact_sheetRead one fact sheet; content comes back once status is completed. Free. Also the status poll after save_fact_sheet generate: queued or processing means poll again in about 60 seconds (typically 5-10 minutes in total), failed means the credits were refunded. Use the content as ground-truth facts, e.g. as create_article's custom_knowledge.
-
save_fact_sheetSave a fact sheet: the business, product or service facts AgilityWriter keeps for every article, the web app and the team. mode is required. manual: you supply content (Markdown); free and saved at once. Use manual when the user supplied the facts. With id, manual replaces a completed sheet's content (other fields optional). generate: AgilityWriter researches the business itself; 2 credits, typically 5-10 minutes, ASYNC: returns an id, poll get_fact_sheet about every 60 seconds. Repeating a generate while the same one is running returns it at no charge.
-
check_ai_answerIs the user's domain or brand cited for ONE question in AI answers? AgilityWriter asks it several times on Google AI Overviews and on ChatGPT (web search) and reports, per engine, how many sampled answers cited the domain or named the brand, the sources cited most, and claims repeated across samples. Costs 1 credit (3 samples per engine) or 2 (6), usually 2-5 minutes. ASYNC: returns an id at once; poll get_report with it every 60 seconds. Samples for the same query and location are reused for up to 24 hours, so a check right after publishing can show earlier answers: re-check days later. Report what was observed ("cited in 2 of 3 sampled answers on <date>"), never that an article caused a citation. For all the questions behind a topic use fanout_report; for every keyword a whole domain is cited for use ai_visibility_audit.
-
fanout_reportMap all the questions behind a topic. From a seed query, AgilityWriter captures the related sub-queries AI answers actually search (ChatGPT's own searches and Google's People Also Ask), samples Google AI Overviews for each, shows which cite the user's domain (and a competitor's), and groups the gaps into clusters with article outlines. Costs 1 credit, +1 with include_chatgpt; usually 10-30 minutes. ASYNC: returns an id at once; poll get_report with it every 60 seconds. Report what was observed ("cited in 2 of 3 sampled answers on <date>"), never that an article caused a citation. Before writing articles from its gaps, show the user the list and the total credit cost and get their confirmation. For one question use check_ai_answer.
-
ai_visibility_auditEvery keyword a whole domain is cited for in AI answers: the Google AI Overview keywords citing it (with estimated traffic) and its ChatGPT mentions (with AI search volume). competitor_domain adds the keywords where the competitor is cited and the user is not. Costs 1 credit, +1 with competitor_domain; usually 1-3 minutes. ASYNC: returns an id at once; poll get_report with it every 60 seconds. get_report returns the top rows; its section parameter pages through the rest. For one question use check_ai_answer.
-
google_ai_overviewThe live Google AI Overview for ONE query: whether Google showed one, its text (tables kept), the pages it cites, and the top 10 organic results. One sample, not a citation check: to see whether the user's brand is cited, use check_ai_answer. create_article already reads the AI Overview itself, so call this when the user wants to see or use it. Costs 1 AW Token only when Google showed an overview; free when there is none, on error, or when the user repeats the same query within 24 hours. Needs 1 AW Token available to start. Usually under a minute. ASYNC: returns an id at once; poll get_report with it every 60 seconds. Answers are cached for 24 hours, so the status can already be completed; report sampled_at with the answer.
-
serp_entitiesThe entities the top Google results for a keyword have in common: up to 50, sorted by how many of the analysed pages use each (noSite), then relevance. minOcr / maxOcr = fewest / most mentions on one page; type, wikiLink and confidenceScore are usually empty. Also returns analyzed_urls; the analysis appears in the web app's Entity Extraction list too. Costs 2 AW Tokens, refunded if it fails or finds no entities; 1-3 minutes. ASYNC: returns an id at once; poll get_report with it every 60 seconds. create_article already researches entities itself, so call this when the user wants the list. For text you already have, extract entities yourself.
-
topical_authority_auditAudit a whole site's topical authority: AgilityWriter reads every page in its sitemap or page list (up to 350 URLs, tag and category pages skipped; more fails and is refunded) and, with the business facts, writes a report in English: a summary, an action plan, topic clusters (a pillar page, what to do with each existing page, missing articles to write, internal links) and local SEO advice. Costs 5 credits; takes 10-50 minutes. ASYNC: returns an id at once; poll get_report with it every 60 seconds. After about 10 minutes, tell the user it keeps running. get_report returns the summary and plan; section clusters (paged) or local_seo returns the rest. At most 2 audits run at once per user; repeating one still running returns it at no charge. Before writing articles from it, show the user the pages and the total credit cost and get their confirmation.
-
get_reportRead a report by its id: check_ai_answer, fanout_report, ai_visibility_audit, google_ai_overview, serp_entities or topical_authority_audit. Free, and also the status poll: status is queued, processing, completed, failed or stalled; follow next_step and poll about every 60 seconds. Only failed and stalled are failures (refunded says whether the credits or AW Tokens came back; charged false means nothing was taken); a long queue is not. After about 10 minutes, stop polling and tell the user it keeps running. Completed results are trimmed: section with offset/limit pages through a full list, dashboard_url opens the whole report in the web app. Fact sheets are read with get_fact_sheet.
-
list_reportsList the user's reports from every report tool, newest first: id, tool, status, title (the domain, query, keyword or audit name), region, language, created_at. Free. Use it to find a report id again, or to see what was already checked before paying for a new one.
-
check_accountVerify the connected AgilityWriter account: confirms the API key is valid and the subscription plan is active (the connector works on any paid plan). Returns the account email. Use check_credits to read the remaining balances.
-
check_creditsRead the connected account's remaining balances before spending anything. Free and read-only. AgilityWriter has TWO SEPARATE currencies that are not interchangeable: (1) "credits" (balance_credits) come with the plan and never reset: create_article, create_webpage, rewrite_from_url 2 each (3-5 on a premium ai_model); polish_article 1; save_fact_sheet generate 2; ai_visibility_audit 1, +1 with competitor_domain; check_ai_answer 1 (3 samples) or 2 (6); fanout_report 1, +1 with include_chatgpt; topical_authority_audit 5. (2) "AW Tokens" (monthly_aw_tokens) are a monthly allowance for premium tools: create_outline 1; serp_entities 2, refunded if none found; google_ai_overview 1, only when Google shows an overview. Also returns the account email and the plan renewal date. Call this when the user asks what something will cost, when they may be running low, or before creating several articles in a row - then tell them the cost and the balance before spending. Do not call it during a polling…
Connect your AI to Agility Writer
Add the official Agility Writer MCP server to Claude, ChatGPT or your editor.
Connect Agility Writer MCP to Claude
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it Agility Writer, paste the address below and click Add.
Connect Agility Writer MCP to ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it Agility Writer and paste the address below.
ChatGPT usually only connects to servers with self-serve sign-in or none.
Connect Agility Writer MCP to Cursor
Opens Cursor if it's installed. If nothing happens, use the JSON below.
Connect Agility Writer MCP to VS Code
Opens VS Code if it's installed. Otherwise add the JSON settings from the Cursor tab to your .vscode/mcp.json.
Agility Writer MCP server questions
Does Agility Writer have an official MCP server?
Yes. Agility Writer publishes its MCP server itself. Its address is on Agility Writer's own domain (mcp.agilitywriter.ai). MartechDB only lists servers a vendor publishes, never community copies.
What is the Agility Writer MCP server URL?
The address is https://mcp.agilitywriter.ai/mcp.
How do I connect Agility Writer MCP to Claude, ChatGPT or Cursor?
In Claude, add https://mcp.agilitywriter.ai/mcp as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http agility-writer https://mcp.agilitywriter.ai/mcp
What can the Agility Writer MCP server do?
It offers 28 tools, including create_article, create_outline, get_outline_status, rewrite_from_url and get_article_status (as listed on 22 Nov 2026).
Is the Agility Writer MCP server in the official MCP Registry?
No. Agility Writer hasn't published it to the official MCP Registry.
Is the Agility Writer MCP server free to use?
No, it needs a paid plan. Plan needed: Every paid plan, including Basic. It is metered in units or credits. From Agility Writer's own pages, checked on 7 Oct 2026.
Is the Agility Writer MCP server working?
Yes. It answered our most recent check. We last checked it on 22 Nov 2026.
What are the alternatives to Agility Writer's MCP server?
In AI writing & translation, the most agent-friendly alternatives with an official MCP server are AI Course Creator (97/100), RightBlogger (95/100), Supergrow (95/100), Storychief (94/100) and Sapling (94/100). Agility Writer scores 55/100 on the same index.
Alternatives to Agility Writer's MCP server
Vendors in AI writing & translation with an official MCP server, the most agent-friendly first. Agility Writer scores 55/100.
AI Course Creator
minicoursegenerator.com
RightBlogger
rightblogger.com
Supergrow
supergrow.ai
Storychief
storychief.io
Sapling
sapling.ai
Change history
What we've seen change for Agility Writer, newest first.
-
Agility Writer: Agility Writer MCP server: 12 tools added (now 28)
Use with AI
Connect your AI to MartechDB
Then ask it about Agility Writer, or any of the 1,850 marketing tools with an official MCP server. Free, no sign-in.
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it MartechDB, paste the address below and click Add. There's no sign-in.
The free plan allows one custom connector. On Team and Enterprise plans, an owner adds the connector first.
Claude Code
Run this in your terminal:
ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it MartechDB, paste the address below and choose No authentication.
Developer mode is on Plus and Pro plans, and on Business, Enterprise and Edu if an admin allows it.
API
The same data as JSON, with no sign-in. See the OpenAPI description for every endpoint and field.
CLI
Search the directory and print the command to connect a vendor's server, from your terminal. Needs Node 18 or later. View on npm
Show that your MCP server is verified
If you work at Agility Writer, add this badge to your MCP docs or README. It's free, it's the same for every vendor, and it updates from our daily checks: it shows uptime while the server responds, and says so if it stops.
Something wrong or out of date? Suggest a correction or email us, and we'll check it against the evidence. Every correction we make is listed on Corrections.