---
title: "Tools"
description: "Explore the current MazeGraph and WordPress tool inventory, what each tool does, where it can run, and the checks that control access."
image: "https://mazegraph.com/docs/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://mazegraph.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

MazeGraph 1.3.0 contains **99 first-party tools** in its checked-in inventory: **82 read-effect tools and 17 write-effect tools**. The inventory also includes three WordPress Core abilities. Other Core and plugin abilities can appear at runtime, depending on WordPress, active integrations, enabled MazeGraph modules, and the current person.

The catalogue groups tools by source and offers search, source/type/pack filters, grid and list views, and descriptions. Counts describe registered entries; they do not mean every tool is available to every person. The WooCommerce group contains 32 tools in the source inventory and appears only when WooCommerce and the MazeGraph WooCommerce module are available.

## What the catalogue labels mean

| Label | Meaning |
| --- | --- |
| Read / Write | Whether the tool is declared to read data or change site data. Delegation is classed as a read effect, although it starts off and can start another model run. |
| Data | Sensitivity of the information the tool handles: public, site, personal, or financial. This is a data label, not an access grant. |
| Surfaces | Where the tool may be made available: MazeGraph chat, an MCP connection, or a direct WordPress Ability call. Policy and the tool permission callback still control execution. |
| Permission | A short description of the WordPress permission check. The registered callback and MazeGraph policy make the decision; descriptive metadata does not grant a capability. |

A tool must pass the site-wide tool setting, its own catalogue switch, the selected assistant scope, the current person’s WordPress capabilities and object-level checks, and deterministic MazeGraph policy. The registry checks permission again immediately before execution. Read [Policy and safeguards](/docs/policy-and-safeguards/) for the decision order.

## WordPress Core abilities

| Tool | Data | Surfaces | What it does |
| --- | --- | --- | --- |
| <code>core/get-environment-info</code> | Site | Chat, MCP, Ability | Read WordPress and server environment facts. |
| <code>core/get-site-info</code> | Site | Chat, MCP, Ability | Read basic site information. |
| <code>core/get-user-info</code> | Personal | Chat, MCP, Ability | Read information about the current user. |

## MazeGraph tools

### Content and draft operations

| Tool | Effect | Data | Surfaces | What it does |
| --- | --- | --- | --- | --- |
| <code>maze-graph/audit-content-accessibility</code> | Read | Site | Chat, MCP, Ability | Looks for images without alt text, skipped heading levels and vague link text on one page of items. |
| <code>maze-graph/audit-content-completeness</code> | Read | Site | Chat, MCP, Ability | Reports missing title, body, excerpt or featured image across one bounded content page. |
| <code>maze-graph/audit-content-freshness</code> | Read | Site | Chat, MCP, Ability | Summarizes modification age across one bounded selection and lists a small stale-content sample. |
| <code>maze-graph/audit-content-images</code> | Read | Site | Chat, MCP, Ability | Lists readable items on one page that have no featured image or an image block without a media id. |
| <code>maze-graph/audit-taxonomy-coverage</code> | Read | Site | Chat, MCP, Ability | Finds readable content missing one or more required terms in an explicitly selected taxonomy. |
| <code>maze-graph/audit-unused-media</code> | Read | Site | Chat, MCP, Ability | Lists media on one page that no item uses as a featured image or in its content. |
| <code>maze-graph/check-publishing-readiness</code> | Read | Site | Chat, MCP, Ability | Checks fixed completeness requirements for one item you can edit. |
| <code>maze-graph/compare-content-revisions</code> | Read | Site | Chat, MCP, Ability | Compares two revisions of the same item and returns a short plain-text diff. |
| <code>maze-graph/content-summary</code> | Read | Site | Chat, MCP, Ability | Counts content by type and status, comments by status, media by kind, and terms per taxonomy. |
| <code>maze-graph/create-draft-post</code> | Write | Site | Chat | Creates a new draft post or page with a title and text. |
| <code>maze-graph/create-term</code> | Write | Site | Chat | Creates one category, tag or other term. |
| <code>maze-graph/find-internal-link-issues</code> | Read | Site | Chat, MCP, Ability | Checks stored links in a bounded content page for internal WordPress targets that do not resolve. |
| <code>maze-graph/get-comment-summary</code> | Read | Site | Chat, MCP, Ability | Counts comments by status. |
| <code>maze-graph/get-content</code> | Read | Site | Chat, MCP, Ability | Returns one post, page or other item by id: title, status, dates, author, categories and tags, and its text without HTML (shortened when long). |
| <code>maze-graph/get-content-change-history</code> | Read | Site | Chat, MCP, Ability | Lists a bounded Maze change journal summary for one readable content item, without session details. |
| <code>maze-graph/get-content-revisions</code> | Read | Site | Chat, MCP, Ability | Lists recent revisions for one item you can edit, without returning another person’s private content. |
| <code>maze-graph/get-content-structure</code> | Read | Site | Chat, MCP, Ability | Returns the heading outline, block types and counts of one item you can edit. |
| <code>maze-graph/get-media-usage</code> | Read | Site | Chat, MCP, Ability | Shows where one media file is used as a featured image or inside content. |
| <code>maze-graph/list-comments</code> | Read | Personal | Chat, MCP, Ability | Lists recent comments by status (approved, pending, spam), optionally for one post: author name, date, post and a short excerpt. |
| <code>maze-graph/list-content</code> | Read | Site | Chat, MCP, Ability | Lists a bounded page of readable content with a fixed summary projection. |
| <code>maze-graph/list-content-statuses</code> | Read | Site | Chat, MCP, Ability | Counts one content type by status (published, draft, pending, scheduled, private, trash). |
| <code>maze-graph/list-post-types</code> | Read | Public | Chat, MCP, Ability | Lists public or editor-supported content types available to you, excluding internal WordPress types. |
| <code>maze-graph/list-registered-block-types</code> | Read | Public | Chat, MCP, Ability | Lists registered block names, titles and categories. |
| <code>maze-graph/list-scheduled-content</code> | Read | Site | Chat, MCP, Ability | Lists readable items scheduled for the future, soonest first. |
| <code>maze-graph/list-terms</code> | Read | Public | Chat, MCP, Ability | Lists terms of a taxonomy (category by default) with how many items use each. |
| <code>maze-graph/report-duplicate-titles</code> | Read | Site | Chat, MCP, Ability | Finds items among the most recent ones whose titles are the same or nearly the same. |
| <code>maze-graph/report-incoming-links</code> | Read | Site | Chat, MCP, Ability | Lists readable items among the most recent ones that link to one item by its stored address. |
| <code>maze-graph/report-orphan-content</code> | Read | Site | Chat, MCP, Ability | Lists published items that no other recent item links to by a stored address. |
| <code>maze-graph/restore-trashed-content</code> | Write | Site | Chat | Takes one item out of the trash and makes it a draft. |
| <code>maze-graph/search-content</code> | Read | Site | Chat, MCP, Ability | Finds posts, pages and other content by words, type and status. |
| <code>maze-graph/trash-content</code> | Write | Site | Chat | Moves one post, page or other content item to the trash. |
| <code>maze-graph/update-draft-featured-image</code> | Write | Site | Chat | Sets or removes the featured image of a draft or pending post, using an image from the Media Library. |
| <code>maze-graph/update-draft-post</code> | Write | Site | Chat | Changes the title, text or excerpt of a draft or pending post or page. |
| <code>maze-graph/update-draft-terms</code> | Write | Site | Chat | Adds or replaces categories, tags and other terms on a draft or pending post. |
| <code>maze-graph/update-media-text</code> | Write | Site | Chat | Changes the alternative text, caption or title of one file in the Media Library. |
| <code>maze-graph/update-term</code> | Write | Site | Chat | Changes the name, slug, description or parent of one term. |

### Media

| Tool | Effect | Data | Surfaces | What it does |
| --- | --- | --- | --- | --- |
| <code>maze-graph/audit-media-alt-text</code> | Read | Site | Chat, MCP, Ability | Reports missing or duplicate image alt text on a bounded page of readable attachments. |
| <code>maze-graph/get-media-details</code> | Read | Site | Chat, MCP, Ability | Returns dimensions, MIME type, alt text, caption, readable parent and generated size dimensions for one attachment. |
| <code>maze-graph/list-media</code> | Read | Site | Chat, MCP, Ability | Lists a bounded page of readable attachments with safe metadata only. |
| <code>maze-graph/search-media</code> | Read | Site | Chat, MCP, Ability | Searches attachment titles, captions and descriptions; it never reads file contents. |

### Site, structure, and operations

| Tool | Effect | Data | Surfaces | What it does |
| --- | --- | --- | --- | --- |
| <code>maze-graph/count-users</code> | Read | Personal | Chat, MCP, Ability | Returns how many user accounts the site has, in total and by role. |
| <code>maze-graph/get-error-log-tail</code> | Read | Personal | Chat, Ability | Returns the last lines of the WordPress debug log, shortened, with file paths and key-like text masked. |
| <code>maze-graph/get-navigation-menu</code> | Read | Site | Chat, MCP, Ability | Returns one menu as a tree up to three levels deep and 100 items, with sanitized addresses. |
| <code>maze-graph/get-plugin-dependencies</code> | Read | Site | Chat, MCP, Ability | Reports declared plugin dependencies and whether each dependency is installed and active. |
| <code>maze-graph/get-server-info</code> | Read | Site | Chat, MCP, Ability | Returns PHP limits and extensions, the database server, caching, HTTPS, debug and cron settings: what core's environment tool leaves out. |
| <code>maze-graph/get-settings</code> | Read | Site | Chat, MCP, Ability | Returns general, reading, discussion, media and permalink settings from a fixed safe list (never email addresses or keys). |
| <code>maze-graph/get-site-health</code> | Read | Site | Chat, MCP, Ability | Runs the Site Health checks that run on page load and returns each result: good, recommended or critical, with a short explanation. |
| <code>maze-graph/get-template-summary</code> | Read | Site | Chat, MCP, Ability | Counts the active theme's templates and template parts by where they come from (theme or your own edits). |
| <code>maze-graph/get-tool-availability</code> | Read | Site | Ability | Explains why one MazeGraph tool is on, off or unavailable for you. |
| <code>maze-graph/get-update-details</code> | Read | Site | Chat, MCP, Ability | Returns the current and available version of one plugin or theme from the last update check, with the versions it was tested with. |
| <code>maze-graph/list-block-patterns</code> | Read | Public | Chat, MCP, Ability | Lists registered block pattern names, sources and short descriptions without returning pattern markup. |
| <code>maze-graph/list-cron-events</code> | Read | Site | Chat, MCP, Ability | Lists WP-Cron events: hook name, next run, how often it repeats, and whether any are overdue. |
| <code>maze-graph/list-navigation-menus</code> | Read | Site | Chat, MCP, Ability | Lists a bounded page of menus and a shallow item tree with sanitized URLs. |
| <code>maze-graph/list-plugins</code> | Read | Site | Chat, MCP, Ability | Lists installed plugins with name, version, whether each is active, and whether an update is waiting. |
| <code>maze-graph/list-site-templates</code> | Read | Site | Chat, MCP, Ability | Lists available active-theme templates and template parts through supported WordPress APIs without exposing their markup. |
| <code>maze-graph/list-taxonomies</code> | Read | Public | Chat, MCP, Ability | Lists visible taxonomies and their safe labels and attached content types. |
| <code>maze-graph/list-themes</code> | Read | Site | Chat, MCP, Ability | Lists installed themes with version, which one is active (and its parent theme), and whether an update is waiting. |
| <code>maze-graph/list-updates</code> | Read | Site | Chat, MCP, Ability | Lists updates WordPress knows about: core, plugins, themes and translations, as of the last update check. |
| <code>maze-graph/list-user-roles</code> | Read | Personal | Chat, MCP, Ability | Lists the roles on this site with their names and how many accounts hold each. |
| <code>maze-graph/report-term-usage</code> | Read | Site | Chat, MCP, Ability | Lists a bounded page of terms in a taxonomy with WordPress usage counts and unused-term flags. |

### WooCommerce

| Tool | Effect | Data | Surfaces | What it does |
| --- | --- | --- | --- | --- |
| <code>maze-graph/audit-products-missing-data</code> | Read | Financial | Chat, MCP, Ability | Lists products on one page that lack a price, SKU, image, description or category. |
| <code>maze-graph/get-order-line-items</code> | Read | Financial | Chat, MCP, Ability | Returns up to 50 line items of one order you may read: product, quantity and totals. |
| <code>maze-graph/get-order-summary</code> | Read | Financial | Chat, MCP, Ability | Returns a minimized summary for one order: status, dates, totals, and up to 25 line items. |
| <code>maze-graph/get-product-category</code> | Read | Site | Chat, MCP, Ability | Returns one product category with its parent, product count and up to 20 child categories. |
| <code>maze-graph/get-product-summary</code> | Read | Financial | Chat, MCP, Ability | Returns one product in a fixed summary: type, status, price, stock, categories and what is missing. |
| <code>maze-graph/list-coupon-summaries</code> | Read | Financial | Chat, MCP, Ability | Lists coupons with type, amount, usage and expiry. |
| <code>maze-graph/list-order-statuses</code> | Read | Financial | Chat, MCP, Ability | Lists WooCommerce order statuses with how many orders have each. |
| <code>maze-graph/list-orders</code> | Read | Financial | Chat, MCP, Ability | Lists a bounded page of orders with status, date and totals. |
| <code>maze-graph/list-payment-method-statuses</code> | Read | Site | Chat, MCP, Ability | Lists payment methods by name and whether each is enabled. |
| <code>maze-graph/list-product-attributes</code> | Read | Site | Chat, MCP, Ability | Lists global WooCommerce product attributes and the number of terms for each attribute. |
| <code>maze-graph/list-product-categories</code> | Read | Site | Chat, MCP, Ability | Lists a bounded page of product categories with parent and usage counts. |
| <code>maze-graph/list-product-variations</code> | Read | Financial | Chat, MCP, Ability | Lists a bounded page of variations for one product, including SKU, price, stock, and variation attributes. |
| <code>maze-graph/list-products</code> | Read | Financial | Chat, MCP, Ability | Lists a bounded page of WooCommerce products with catalog and stock basics. |
| <code>maze-graph/list-shipping-zone-summaries</code> | Read | Site | Chat, MCP, Ability | Lists shipping zones with how many regions and enabled methods each has. |
| <code>maze-graph/report-coupon-performance</code> | Read | Financial | Chat, MCP, Ability | Shows how often each coupon was used on paid orders in a date range (at most 90 days) and the discount it gave. |
| <code>maze-graph/report-fulfillment-backlog</code> | Read | Financial | Chat, MCP, Ability | Counts processing and on-hold orders and reports how many are older than 24 hours and 7 days. |
| <code>maze-graph/report-orders-by-status</code> | Read | Financial | Chat, MCP, Ability | Counts orders created in a date range (at most 90 days) for each status. |
| <code>maze-graph/report-payment-method-usage</code> | Read | Financial | Chat, MCP, Ability | Counts paid orders by payment method in a date range (at most 90 days). |
| <code>maze-graph/report-product-reviews</code> | Read | Site | Chat, MCP, Ability | Counts product reviews by status. |
| <code>maze-graph/report-refund-summary</code> | Read | Financial | Chat, MCP, Ability | Totals refunds created in a date range (at most 90 days), by currency. |
| <code>maze-graph/report-sales-summary</code> | Read | Financial | Chat, MCP, Ability | Summarizes paid orders by paid date over at most 90 days, grouped by currency. |
| <code>maze-graph/report-shipping-totals</code> | Read | Financial | Chat, MCP, Ability | Totals the shipping charged on paid orders in a date range (at most 90 days), by currency. |
| <code>maze-graph/report-stale-products</code> | Read | Financial | Chat, MCP, Ability | Lists products not edited for a number of days, oldest first. |
| <code>maze-graph/report-stock-alerts</code> | Read | Financial | Chat, MCP, Ability | Counts out-of-stock products and scans up to 200 managed in-stock products for low-stock thresholds. |
| <code>maze-graph/report-stock-by-category</code> | Read | Financial | Chat, MCP, Ability | Counts products in stock, out of stock and on backorder for each product category on one page of categories. |
| <code>maze-graph/report-tax-totals</code> | Read | Financial | Chat, MCP, Ability | Totals the tax charged on paid orders in a date range (at most 90 days), by currency. |
| <code>maze-graph/search-product-variations</code> | Read | Financial | Chat, MCP, Ability | Finds variations of one named variable product by SKU or attribute text. |
| <code>maze-graph/woo-add-order-note</code> | Write | Financial | Chat | Adds one private note, visible to the shop team only, to one WooCommerce order. |
| <code>maze-graph/woo-create-product</code> | Write | Financial | Chat | Creates one simple WooCommerce product as a draft. |
| <code>maze-graph/woo-delete-product</code> | Write | Financial | Chat | Moves one simple product to the trash. |
| <code>maze-graph/woo-update-order-status</code> | Write | Financial | Chat | Changes one order to pending, on-hold, processing, completed, cancelled or failed. |
| <code>maze-graph/woo-update-product</code> | Write | Financial | Chat | Changes the name, prices, descriptions or stock of one simple product. |

### Notes, delegation, and definitions

| Tool | Effect | Data | Surfaces | What it does |
| --- | --- | --- | --- | --- |
| <code>maze-graph/delegate</code> | Read | Site | Chat | Hands a research question about this site to a helper agent, which reads the site with read-only tools in a separate conversation and answers with a short summary. |
| <code>maze-graph/delete-definition</code> | Write | Site | Chat | Removes one of the site's own definitions. |
| <code>maze-graph/get-definition</code> | Read | Site | Chat, MCP, Ability | Returns one definition as JSON, to read it or to start a new one from it. |
| <code>maze-graph/list-definitions</code> | Read | Site | Chat, MCP, Ability | Lists the agents, Studio templates, starter prompts and policy rules this site has, with where each comes from and whether it can be changed here. |
| <code>maze-graph/recall-notes</code> | Read | Personal | Chat, MCP, Ability | Returns notes kept from earlier sessions (the person's own and the site's), newest first, optionally only those containing some words. |
| <code>maze-graph/save-definition</code> | Write | Site | Chat | Creates or changes one of the site's own definitions from JSON: an agent, a Studio template, a starter prompt or a policy rule. |
| <code>maze-graph/save-note</code> | Write | Personal | Chat | Keeps a short note for later sessions, such as a preference or a fact about the site. |

## Defaults and changes

New installs and **Reset to recommended** use a small reading set: <code>maze-graph/search-content</code>, <code>maze-graph/get-content</code>, <code>maze-graph/list-content</code>, <code>maze-graph/content-summary</code>, <code>maze-graph/list-post-types</code>, <code>maze-graph/list-terms</code>, <code>maze-graph/list-media</code>, and <code>core/get-site-info</code>. No write tool is enabled by this reset. Existing installations with prior sessions keep earlier defaults until an administrator resets them. Saved per-tool choices remain in force until reset; newly added tools start off.

Reset previews the changes and clears per-tool overrides only. It does not change the site-wide tool setting, connectors or keys, MCP server settings, session permission modes, or assistant profiles. See [Main assistant tool access](/docs/settings/tools/) for catalogue controls and reset behavior.

MazeGraph’s own MCP sharing exposes only eligible read-effect MazeGraph tools. Tool visibility on an external MCP host is controlled by that host and does not remove the MazeGraph Ability permission callback or policy checks.

Source: https://mazegraph.com/docs/tools/index.mdx
