WordPress

BetterDocs 4.9.7 Adds Free MCP Server, OAuth 2.1, and BYOK AI to WordPress: Pricing & Bloat Review

BetterDocs 4.9.7 (November 17, 2026) refines a knowledge base stack that now ships a free Model Context Protocol (MCP) server, OAuth 2.1 consent, WordPress Abilities API hooks, and multi-provider BYOK AI across 30,000+ active WordPress sites. Here is what stays free, what costs $48–$179+, and how its frontend and database footprint holds up as of November 22, 2026.

By 0xScorPionSon

8 min read

BetterDocs 4.9.7 Adds Free MCP Server, OAuth 2.1, and BYOK AI to WordPress: Pricing & Bloat Review

BetterDocs 4.9.7 WordPress MCP server, OAuth 2.1, Abilities API, and BYOK AI architecture infographic

Executive Summary

BetterDocs – AI Documentation, Knowledge Base, MCP Server, Docs, Wikis, FAQ & Chatbot (v4.9.7, released November 17, 2026) by WPDeveloper has evolved from a traditional WordPress documentation plugin into an AI-native knowledge base with a built-in Model Context Protocol (MCP) server, OAuth 2.1 authorization, WordPress Abilities API registration, and .md Markdown endpoints for external crawlers and coding assistants.

Pricing and install stats verified as of November 22, 2026: BetterDocs runs on 30,000+ active WordPress installations with a 4.8 out of 5 rating across 517 reviews. Unlike WordPress AI plugins that lock MCP connectivity or Bring Your Own Key (BYOK) behind paid tiers, BetterDocs includes its MCP server, Write with AI, AI FAQ Builder, and AI Actions (.md export and one-click assistant handoff) in its free WordPress.org plugin. Paid BetterDocs Pro plans—starting at $48/year during Black Friday/Cyber Monday 2026 (regularly $69/year)—unlock AI Content Intelligence, API docs, Git sync, and multiple/internal knowledge bases, while the AI Chatbot is sold separately for $8.99/month or $69/year per site (and requires Pro).

Growth Signals & WordPress.org Telemetry

BetterDocs is an established WPDeveloper product rather than a single-purpose AI wrapper, giving its AI and MCP rollout a much larger production base than newer WordPress agent plugins. Its WordPress.org listing shows steady maintenance across Gutenberg, Elementor, and Full Site Editing (FSE) workflows, alongside active support responsiveness.

Telemetry Metric Verified Value (November 22, 2026) Source
Current Version 4.9.7 (November 17, 2026) WordPress.org
Active Installations 30,000+ WordPress.org
WordPress Compatibility Requires 6.4+, Tested up to 7.1.5 WordPress.org
PHP Requirement 7.4 or higher WordPress.org
User Rating 4.8 / 5 (517 reviews: 480 5-star, 12 1-star) WordPress.org
Support Resolution 4 out of 6 issues resolved in last 2 months WordPress.org

Release Timeline: How BetterDocs Became AI- and MCP-Native

Looking at the WordPress.org changelog, WPDeveloper layered AI and agent protocols onto BetterDocs across six key 2026 milestones:

  • v4.8.0 & v4.8.2 (August 4 & 20, 2026): Added multi-provider BYOK support (OpenAI, Google Gemini, Anthropic Claude) plus document/image ingestion (TXT, MD, DOCX, PDF, PNG, JPG, WEBP) for Write with AI.
  • v4.9.0 (August 27, 2026): Shipped the built-in MCP Server with OAuth 2.1 consent, pairing tokens, and rate limiting, and registered docs, categories, tags, glossaries, FAQs, settings, and analytics with the WordPress Abilities API.
  • v4.9.3 (September 27, 2026): Launched AI Actions (a "Copy page" Markdown button and .md suffix on every doc URL) and fixed an MCP OAuth discovery collision when another MCP-enabled plugin is active on the same site.
  • v4.9.4 (October 8, 2026): Added audio/video transcription (up to 25 MB via OpenAI or Gemini keys), browser-native Listen text-to-speech, and automatic animated GIF-to-MP4 conversion.
  • v4.9.6 (November 10, 2026): Updated the AI Content Suite model picker with GPT-6 Luna, GPT-6.1 Sol, GPT-6 Astra, Gemini 3.5 Flash Lite, Gemini 3.8 Flash, and Claude Haiku/Sonnet/Opus 5.5—complete with model price badges—and added a "Delete Data on Uninstall" setting.
  • v4.9.7 (November 17, 2026): Added Knowledge Base–scoped search, Polylang FAQ translation, security enhancements, and fixes for Help Scout migration, CSV imports, and concurrent analytics tracking.

AI Architecture, Pricing Breakdown & Verification Timestamp

BetterDocs splits its AI architecture into three distinct surfaces: authoring (BYOK), agent access (MCP + Abilities API + .md), and visitor support (Pro + Chatbot add-on).

How the MCP Server & Abilities Layer Work

Turning on BetterDocs → MCP exposes a per-site MCP endpoint on your own domain. Clients such as Claude, ChatGPT, Cursor, and VS Code authenticate via OAuth 2.1 consent or pairing tokens, bounded by rate limiting and your WordPress user role. Because v4.9.0 also registers BetterDocs entities with the WordPress Abilities API, third-party Abilities-aware adapters can discover and invoke documentation tools without custom glue code.

On the public retrieval side, BetterDocs appends .md support (or Accept: text/markdown content negotiation) to every documentation URL so AI crawlers and coding assistants can fetch clean Markdown instead of themed HTML.

Verified Pricing & BYOK Breakdown (November 22, 2026)

Pricing and install stats verified as of November 22, 2026 on BetterDocs.co and the BetterDocs Features page. Note that BetterDocs is running a Black Friday/Cyber Monday 2026 promotion (up to 40% off) alongside its standard renewal rates:

Plan / Tier BFCM 2026 Promo / Regular Price Site Limit Included AI & MCP Capabilities Verified Date
Free (WordPress.org) $0 Unlimited MCP Server (OAuth 2.1), Abilities API, Write with AI (BYOK), AI FAQ Builder, AI Actions (.md), Sample Docs Nov 22, 2026
Starter (Pro Yearly) $48/yr ($69/yr regular) 1 active site Everything in Free + AI Analytics & Content Intelligence, AI Instant Answer, OpenAPI Docs, Git Sync, Multiple/Internal KBs Nov 22, 2026
Innovator (Pro Yearly) $97/yr ($149/yr regular) Unlimited sites All Pro features + 1 year of updates & support Nov 22, 2026
Visionary (Pro Lifetime) $179 one-time ($299 regular) Unlimited sites All Pro features + lifetime updates & support Nov 22, 2026
AI Chatbot Add-On $8.99/mo or $69/yr Per site (requires Pro) RAG visitor chat widget grounded in docs + WooCommerce/FluentCart catalog, running on OpenAI or Google Gemini BYOK Nov 22, 2026

BYOK & Credit Mechanics: BetterDocs does not sell proprietary AI word credits. For Write with AI, AI Doc Summarizer, and audio/video transcription, you supply your own API key from OpenAI, Anthropic Claude, Google Gemini, DeepSeek, OpenRouter, or any OpenAI-compatible endpoint—and v4.9.6 lets you assign a cheaper model for summaries and a stronger model for long-form drafting. The only feature that runs without an API key is AI Sample Docs, which sends site metadata and short post/product excerpts to api.betterdocs.co to scaffold an initial knowledge base.

WordPress Performance Footprint, Security & Lock-In Check

Adding 23 Gutenberg blocks, Elementor widgets, an MCP server, and AI modals to a WordPress site raises valid questions about frontend asset bloat, database autoloading, and security.

Frontend Bloat & Asset Loading

WPDeveloper has addressed several historical bloat vectors in recent releases:

  • Conditional script loading: Version 3.8.14 disabled BetterDocs JS and CSS on pages where BetterDocs is not used, and v4.9.4 (October 8, 2026) updated the Category Grid block script so it loads only on pages where the block renders—while also removing stale Essential Blocks CSS that had been loading across every page.
  • GIF-to-MP4 weight reduction: Version 4.9.4 automatically serves animated documentation GIFs as looping, muted MP4 videos, cutting page weight on media-heavy technical docs.
  • Browser-native TTS: The Listen audio pill runs directly in the reader's browser rather than generating and hosting heavy MP3 files on your WordPress server.

Database Cleanup & Lock-In

On the lock-in front, BetterDocs stores documentation as standard WordPress custom post types and taxonomies, supports CSV/XML import and export, and offers bidirectional GitHub/GitLab Markdown sync on Pro plans. If you decide to remove the plugin later, v4.9.6 introduced an explicit "Delete Data on Uninstall" toggle so wp_options rows and plugin tables do not linger in your database.

Security, OAuth Isolation & External Data Boundaries

  1. Zero Background Telemetry by Default: Per the WordPress.org External Services disclosure, BetterDocs contacts no external servers unless you opt in to WPInsight usage tracking (send.wpinsight.com), configure a GA4 ID, trigger AI Sample Docs (api.betterdocs.co), or enter a BYOK provider key.
  2. API Key Hygiene: According to BetterDocs.co, BYOK keys are stored on your own WordPress server, stripped from exports, and never transmitted to BetterDocs servers during normal BYOK generation.
  3. Multi-Plugin MCP Isolation: In v4.9.3 (September 27, 2026), BetterDocs fixed an important edge case where its MCP OAuth discovery endpoint could answer for—or be answered by—another MCP-enabled plugin on the same site. If you run BetterDocs alongside the official WordPress MCP Adapter or another agent plugin, ensure you are on 4.9.3 or newer.
  4. Role & Privacy Controls: MCP actions inherit the authenticated WordPress user's role capabilities, and BetterDocs Analytics anonymizes visitor IPs by default with an optional cookieless mode.

Verdict: Who Should Install BetterDocs 4.9.7?

  • Strong fit: Product teams, SaaS companies, and WooCommerce stores that want a full knowledge base plus a free, OAuth 2.1–secured MCP server and .md AI endpoints without paying for another MCP connector plugin or vendor credit markup.
  • Skip or defer: General-purpose blogs that do not need a structured /docs knowledge base, or teams looking for a full-site page builder agent (where tools like ZIP AI or Elementor's agent workflows are better suited). Also note that if your main goal is a visitor-facing AI support chatbot, that feature is not free—it requires both BetterDocs Pro ($48+/yr) and the AI Chatbot add-on ($69/yr or $8.99/mo) plus your own OpenAI/Gemini key.

Frequently Asked Questions (FAQ)

1. Is the BetterDocs MCP server really free?

Yes. As verified on November 22, 2026, the MCP server, WordPress Abilities API integration, OAuth 2.1 consent flow, .md AI Actions endpoints, and Write with AI (BYOK) are all included in the free WordPress.org version of BetterDocs (v4.9.7).

2. Does BetterDocs charge AI credit markups?

No. BetterDocs uses a Bring Your Own Key (BYOK) model for writing, summarizing, and transcribing docs, supporting OpenAI, Anthropic Claude, Google Gemini, DeepSeek, OpenRouter, and OpenAI-compatible endpoints. You pay your LLM provider directly at standard API rates.

3. Do I need BetterDocs Pro for the AI Chatbot?

Yes. The BetterDocs AI Chatbot is a separate paid add-on ($8.99/month or $69/year per site) and requires an active BetterDocs Pro license (starting at $48/year during Black Friday 2026, regularly $69/year), plus an OpenAI or Google Gemini API key.

4. Does BetterDocs slow down non-documentation pages?

Recent updates (v3.8.14 and v4.9.4) restrict BetterDocs scripts and Category Grid assets to pages where BetterDocs blocks or docs actually render, and v4.9.4 removed stale Essential Blocks CSS from loading site-wide.

5. Is it safe to run BetterDocs MCP alongside other WordPress MCP plugins?

Yes, provided you run v4.9.3 or newer. Version 4.9.3 (September 27, 2026) resolved an MCP OAuth discovery collision where multiple MCP plugins on the same WordPress site could intercept each other's metadata requests.

6. Can I clean up BetterDocs data if I uninstall it?

Yes. Version 4.9.6 (November 10, 2026) added a "Delete Data on Uninstall" setting, and Pro users can also sync or export their documentation as Markdown via GitHub/GitLab or CSV/XML before uninstalling.

Sources

  1. WordPress.org Plugin Directory — BetterDocs – AI Documentation, Knowledge Base, MCP Server, Docs, Wikis, FAQ & Chatbot (v4.9.7) (Released November 17, 2026; verified November 22, 2026)
  2. BetterDocs Official Website — BetterDocs – AI Knowledge Base Plugin for WordPress (Verified November 22, 2026)
  3. BetterDocs Features & Pricing — Features – BetterDocs (Verified November 22, 2026)

More on WordPress

WordPress

StifLi Flex MCP 3.6.1 Review: 122+ Tools, Session Rollback & WooCommerce AI

StifLi Flex MCP 3.6.1 by Esteban García packs 122+ built-in WordPress and WooCommerce MCP tools, OAuth 2.1 with PKCE, and before/after snapshot rollback into a $0 GPLv2+ plugin. This technical audit examines its WordPress.org telemetry, MCP 2026-07-28 compatibility, zero-build PHP footprint, optional BYOK Copilot/Chat Agent add-ons, and rollback boundaries.

9 min read

Tell us what is not working

A thirty-minute call, no deck and no obligation. You will leave with a straight answer about whether this is worth building - including if that answer is no.

Start a project

Direct line

hello@codebumble.net
Dhaka, Bangladesh  :   local timeCalls in English or Bangla