BetterDocs abilities, governed through the Bridge

An agent can list, read, create, update and delete docs, doc categories/tags/glossary terms, FAQs and FAQ groups, attach FAQ groups to a doc, read per-doc view analytics, read the plugin's status, and read or update its settings.

Abilities
239 read9 write5 destructive
Active installs
30K+
Rating
96% (513 ratings)
Version
4.9.3
Requires
WP 6.4+, PHP 7.4+
Last updated
2026-09-27

What has to be true first

Needs WordPress 6.9 or later. Doc abilities require edit_docs (delete-doc requires delete_docs); term abilities require manage_doc_terms, edit_doc_terms, delete_doc_terms, or edit_docs depending on the operation; FAQ abilities require edit_others_docs; settings abilities require edit_docs_settings; the analytics ability requires read_docs_analytics.

  • BetterDocs also ships 13 Pro-only stub abilities under a separate betterdocs-pro/ namespace that register as inert placeholders describing a Pro feature; on a Free site calling one returns an upsell error instead of executing, and Pro replaces them with real abilities of the same id when active. These are not counted among the 23 abilities below.

The 23 BetterDocs abilities

Grouped by what each one can change. Every one starts off until you enable it.

Read 9

  • Read

    Get status

    Reads plugin versions, Pro state, content counts, and the current user's capabilities.

    Permission
    edit_docs
    MCP tool
    aafm-bridge-betterdocs-get-status
  • Read

    Get doc

    Reads a single doc by id or slug, including its content, terms, and view/reaction counts.

    Permission
    edit_docs
    MCP tool
    aafm-bridge-betterdocs-get-doc
  • Read

    List docs

    Lists and filters docs by search text, category, tag, knowledge base, status, author, or slug.

    Permission
    edit_docs
    MCP tool
    aafm-bridge-betterdocs-list-docs
  • Read

    List terms

    Lists doc categories or doc tags with their doc counts, parents, and knowledge bases.

    Permission
    edit_docs
    MCP tool
    aafm-bridge-betterdocs-list-terms
  • Read

    List FAQ groups

    Lists FAQ groups with their question counts and published/draft state.

    Permission
    edit_others_docs
    MCP tool
    aafm-bridge-betterdocs-list-faq-groups
  • Read

    List FAQs

    Lists FAQs with their questions, answers, and groups, filterable by group, search text, or status.

    Permission
    edit_others_docs
    MCP tool
    aafm-bridge-betterdocs-list-faqs
  • Read

    Get settings schema

    Lists every setting the site accepts, with its type, default, and allowed values.

    Permission
    edit_docs_settings
    MCP tool
    aafm-bridge-betterdocs-get-settings-schema
  • Read

    Get settings

    Reads current plugin settings merged with defaults; API keys are masked.

    Permission
    edit_docs_settings
    MCP tool
    aafm-bridge-betterdocs-get-settings
  • Read

    Get doc analytics

    Reads one doc's views, unique views, and reactions, for all time or a date range.

    Permission
    read_docs_analytics
    MCP tool
    aafm-bridge-betterdocs-get-doc-analytics

Write 9

  • Write

    Create doc

    Creates a new doc from markdown, HTML, or block content, with optional categories, tags, and knowledge bases.

    Permission
    edit_docs
    MCP tool
    aafm-bridge-betterdocs-create-doc
  • Write

    Update doc

    Updates an existing doc by id; only the fields sent are changed, and term lists sent replace the doc's current terms.

    Permission
    edit_docs
    MCP tool
    aafm-bridge-betterdocs-update-doc
  • Write

    Create term

    Creates a doc category or doc tag; an existing name is returned unchanged.

    Permission
    manage_doc_terms
    MCP tool
    aafm-bridge-betterdocs-create-term
  • Write

    Update term

    Updates a doc category or doc tag by id; a knowledge_bases value sent replaces the category's current list.

    Permission
    edit_doc_terms
    MCP tool
    aafm-bridge-betterdocs-update-term
  • Write

    Create FAQ group

    Creates an FAQ group; an existing name is returned unchanged.

    Permission
    edit_others_docs
    MCP tool
    aafm-bridge-betterdocs-create-faq-group
  • Write

    Update FAQ group

    Renames an FAQ group or changes its description, slug, or published state; omitted fields keep their current values.

    Permission
    edit_others_docs
    MCP tool
    aafm-bridge-betterdocs-update-faq-group
  • Write

    Create FAQ

    Creates an FAQ (a question and answer), optionally in a group.

    Permission
    edit_others_docs
    MCP tool
    aafm-bridge-betterdocs-create-faq
  • Write

    Update FAQ

    Edits an FAQ's question, answer, group, or status; omitted fields keep their current values.

    Permission
    edit_others_docs
    MCP tool
    aafm-bridge-betterdocs-update-faq
  • Write

    Attach FAQ groups to a doc

    Shows one or more FAQ groups on a doc by writing an FAQ block into its content.

    Permission
    edit_docs
    MCP tool
    aafm-bridge-betterdocs-attach-faq

Destructive 5

  • Destructive

    Delete doc

    Trashes a doc, or permanently deletes it when force is true.

    Permission
    delete_docs
    MCP tool
    aafm-bridge-betterdocs-delete-doc
  • Destructive

    Delete term

    Permanently deletes a doc category or doc tag; docs in it become uncategorized rather than being deleted.

    Permission
    delete_doc_terms
    MCP tool
    aafm-bridge-betterdocs-delete-term
  • Destructive

    Delete FAQ group

    Deletes an FAQ group; its questions survive without a group unless with_all_faqs is true, which deletes them too.

    Permission
    edit_others_docs
    MCP tool
    aafm-bridge-betterdocs-delete-faq-group
  • Destructive

    Delete FAQ

    Deletes an FAQ, which is permanent since FAQs are a custom post type that does not use the trash.

    Permission
    edit_others_docs
    MCP tool
    aafm-bridge-betterdocs-delete-faq
  • Destructive

    Update settings

    Changes plugin settings; every key is validated before anything is written, and enable_mcp cannot be changed this way.

    Permission
    edit_docs_settings
    MCP tool
    aafm-bridge-betterdocs-update-settings

How to switch these on

Four steps from two active plugins to a governed connection.

  1. Install BetterDocs and Agent Abilities for MCP

    Both plugins need to be active on the same WordPress site. BetterDocs registers its own abilities; this plugin discovers and governs them.

  2. Open the Other plugins screen

    In Agent Abilities for MCP, open the Bridge tab (labeled "Other plugins" in the admin). Abilities from every registered plugin appear there, grouped by the plugin that registered them.

  3. Enable one ability at a time

    Every ability from BetterDocs starts off. Turn on only the ones you want an agent to reach, or enable the whole set in one click.

  4. Connect as a least-privilege user

    Approve the connection as a WordPress account scoped to what you actually want the agent to do. Each call still re-checks that account’s capability before it runs.

Read more in how bridging works or the full documentation.

Frequently asked questions

Does BetterDocs work with the Bridge?

Yes. All 23 free abilities register unconditionally into the core Abilities API (deliberately not gated by the plugin's own enable_mcp toggle), each with an explicit readonly/destructive annotation, so the Bridge discovers and can wrap every one of them.

What has to be true for BetterDocs's abilities to register?

BetterDocs also ships 13 Pro-only stub abilities under a separate betterdocs-pro/ namespace that register as inert placeholders describing a Pro feature; on a Free site calling one returns an upsell error instead of executing, and Pro replaces them with real abilities of the same id when active. These are not counted among the 23 abilities below..

Does BetterDocs need anything special to work with the Bridge?

Needs WordPress 6.9 or later. Doc abilities require edit_docs (delete-doc requires delete_docs); term abilities require manage_doc_terms, edit_doc_terms, delete_doc_terms, or edit_docs depending on the operation; FAQ abilities require edit_others_docs; settings abilities require edit_docs_settings; the analytics ability requires read_docs_analytics.

More Content plugins

An agent can discover ACF field groups, custom post types, and custom taxonomies that the site owner has opted into AI access, then list, read, create, update, and delete items of those content types along with their custom field values.

Content2M+ active installs
7 read7 write2 destructive
Built-in integration tooView abilities

An agent can list and inspect tables, charts and media on the site, read the plugin's system info, licence tier and changelog, and create or edit Simple tables and charts, upload images from a URL, and update table, chart, or global plugin settings.

Content60K+ active installs
9 read8 write
View abilities

Verified from BetterDocs's own free wordpress.org code on 28 September 2026, not from its marketing claims. Not every ability listed here has been run end to end against a live site. Plugin authors change their code, so a name, a capability, or a condition can be different in a later release. This site is not affiliated with, or endorsed by, WPDeveloper or BetterDocs. Back to the full directory.

Back to the plugin directory

Bridge BetterDocs, keep the same control.

Every ability starts off, is scoped to the user you connect, and is written to the same audit log as core. Turn on only what you need.

Off by default. Capability checked on every call.