Support integration
BetterDocs MCP
BetterDocs keeps a doc as its own docs post type under a hierarchical doc_category taxonomy and a flat doc_tag taxonomy, with BetterDocs Pro adding a knowledge_base taxonomy for several knowledge bases. WP MCP Pro reads docs (list-docs filtered by category, tag, status or search, get-doc, and list-categories with the plugin's own doc order and, on Pro, the knowledge bases), kept to the docs the caller may read so drafts and private docs of others stay hidden. Docs are content, like posts, so the writes are on by default: create-doc inserts a doc (draft unless a status says otherwise) with its categories and tags, recorded for rollback so the undo trashes it; update-doc changes a doc's title, content, excerpt, status, categories or tags under a post snapshot, so rollback-operation puts it back. Both go through wp_insert_post and wp_update_post, so BetterDocs's own hooks keep its category orders current, and each takes the docs post type's own capabilities.
In practice
How BetterDocs work goes with an agent.
A BetterDocs knowledge base is plain WordPress content with a few extra taxonomies: each doc is a post of the docs type, filed under doc_category, tagged with doc_tag, and with BetterDocs Pro also placed in a knowledge_base. A category carries its own hand-set doc order, and each doc keeps a view count in meta. That makes documentation work a natural fit for an agent: find the docs that are out of date, draft a new one in the right category, correct a policy that changed. WP MCP Pro reads and edits docs while leaving BetterDocs' own ordering hooks in charge.
Which docs in the Billing category are still drafts, and how many views do the published ones get?
Runs betterdocs-list-categories to find the category id, then betterdocs-list-docs with that category and status draft, then again for publish. Results include views per doc and only docs the caller may read.
Write a draft doc "How to export your data" under Account and tag it exports and gdpr.
Runs betterdocs-create-doc with the category id and the two tag names, status left at draft. The create is recorded for rollback, and the undo moves the doc to the trash.
The refund window changed to 30 days. Update the Refund Policy doc.
Runs betterdocs-get-doc, then betterdocs-update-doc with the new content. Only the fields given change, the post is snapshotted first, and rollback-operation restores the old text.
Publish the draft "Reset your password" doc.
Runs betterdocs-update-doc with status publish. Publishing needs the publish_docs capability, so a user who can only edit gets operation_denied and the doc stays a draft.
What your AI can do
Real BetterDocs operations, every write reversible.
- List docs filtered by category, tag, status or search
- Read one doc with its categories, tags, knowledge bases and views
- List doc categories with BetterDocs' own order, and knowledge bases on Pro
- Create and update docs with their categories and tags
- Roll back a created or updated doc exactly
Example prompts
Example BetterDocs prompts.
List the published docs in the Getting Started category.
Draft a doc called "Resetting your password" under the Account category.
Update the "Billing FAQ" doc with the new refund window.
Under the hood
The BetterDocs calls, under the hood.
plugin-data-read({ integration: "betterdocs", operation: "list-docs", args: { status: "publish" } }), only docs you may read
plugin-data-write({ integration: "betterdocs", operation: "update-doc", args: {…} }), post snapshot, reversible
Safety and access
What can be undone on BetterDocs, and what costs what.
Recoverable on BetterDocs
- A created doc is recorded for rollback, and the undo moves it to the trash.
- betterdocs-update-doc is snapshotted as a post (fields, meta and terms) and restored with rollback-operation.
- Categories and tags replace the doc's set on update, and the snapshot returns the previous set.
BetterDocs limits and opt-ins
- There is no delete and no write to categories or knowledge bases. Only docs are created and updated.
- Writes accept the statuses publish, draft, pending and private. A doc cannot be scheduled through this op.
- Categories must already exist as doc_category ids; an unknown id is refused with unknown_category. Tag names are created when new.
- Drafts and private docs belonging to other users stay hidden from reads.
Free or Pro: BetterDocs support is a Pro feature, added in 0.9.0. The free plugin does not include it. The reads and both writes are on once Pro is active and BetterDocs is loaded, with no opt-in filter, because docs are ordinary content. That is separate from BetterDocs Pro, the plugin: listing knowledge bases needs that plugin, while the rest works with BetterDocs alone. Every op takes the docs post type's own capabilities, such as edit_docs and publish_docs.
Part of WP MCP Pro
The BetterDocs integration is part of WP MCP Pro.
One Pro licence unlocks the BetterDocs tools and every other Pro integration on this site: Elementor deep editing, the other page builders, the forms adapter pack and more, 133 Pro tools in all. The free plugin still covers the rest of WordPress and the full snapshot and undo engine, so you can try the safety model before you buy.
Frequently asked
BetterDocs MCP: questions, answered.
Are BetterDocs writes on by default?
Yes. Docs are content like posts, so create-doc and update-doc are on, each taking the docs post type's own capabilities (edit_docs, publish_docs). A create's undo trashes the doc; an update is restored from a post snapshot.
Does it keep BetterDocs' category ordering correct?
Yes. Writes go through wp_insert_post and wp_update_post, so BetterDocs's own hooks put a doc into the order of every category it joins, exactly as its editor would.
Can the BetterDocs integration reorder docs inside a category?
Not directly. The hand-set order is BetterDocs' own term meta, which it maintains through its save and term hooks. WP MCP lists categories in that order, and a doc you create or recategorise is put into each category's order by BetterDocs itself, as its editor would.
Does the BetterDocs integration see knowledge bases?
Yes, if BetterDocs Pro is installed. betterdocs-list-categories then also returns the knowledge_base terms, and each doc lists its knowledge bases. Without BetterDocs Pro the taxonomy does not exist, and docs simply show no knowledge bases.
How are doc view counts exposed?
Each doc returned by list and get includes a views number read from BetterDocs' own _betterdocs_meta_views meta. It is read only. WP MCP never writes the counter, so editing a doc does not reset or inflate it.
Can I search docs by text?
Yes. betterdocs-list-docs takes a search string alongside category, tag slug and status filters, and pages up to 100 per call. A category filter includes its subcategories, so asking for a parent category returns the whole branch.
Related integrations
More integrations for the same agent.
MCP for Fluent Support
ProSupport, 2 tools.
MCP for Awesome Support
ProSupport, 2 tools.
MCP for Elementor
ProPage builders, 14 tools.
MCP for Gutenberg
FreePage builders, 4 tools.
MCP for Bricks
ProPage builders, 3 tools.
MCP for Divi (4 and 5)
ProPage builders, 3 tools.
Browse the full Integrations hub, or read more on the WordPress MCP plugin.