---
title: "Agents"
description: "Learn what MazeGraph's built-in agents do and which tools each one can use."
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.

# Agents

Agents give the assistant a defined role and a specific set of tools. A primary agent handles a conversation or a feature such as Content Studio. A helper agent is called by another agent for a separate, read-only research task. The agent list is a read-only view; its source and tool patterns explain what it may be asked to do.

## Built-in agents

In the tool lists below, names without the `maze-graph/` prefix are abbreviated for readability; they use the same namespace.

| Agent | Role | Available tools | Step limit |
| --- | --- | --- | --- |
| **Assistant** (`assistant`) | General help across WordPress content, media, and site tools. | `core/*` plus `maze-graph/content-summary`, `count-users`, `create-draft-post`, `delete-definition`, `delegate`, `get-content`, `get-definition`, `get-server-info`, `get-settings`, `get-site-health`, `list-comments`, `list-cron-events`, `list-definitions`, `list-plugins`, `list-post-types`, `list-terms`, `list-themes`, `list-updates`, `recall-notes`, `save-definition`, `save-note`, `search-content`, and `update-draft-post`. | Site default |
| **Content writer** (`studio-content`) | Writes or rewrites drafts in Content Studio. Hidden from the regular agent picker; used by Content Studio. | `maze-graph/search-content`, `get-content`, `content-summary`, `list-terms` | Up to 6 |
| **Content** (`content-auditor`) | Reviews content, revisions, media, and publishing quality. | `maze-graph/list-post-types`, `list-content`, `get-content-revisions`, `compare-content-revisions`, `get-content-change-history`, `audit-content-completeness`, `audit-content-freshness`, `find-internal-link-issues`, `audit-taxonomy-coverage`, `check-publishing-readiness`, `list-media`, `search-media`, `get-media-details`, `audit-media-alt-text` | Up to 6 |
| **Debug** (`debug`) | Checks site health, configuration, plugins, themes, and structure. | `maze-graph/get-server-info`, `get-settings`, `get-site-health`, `list-plugins`, `list-themes`, `list-updates`, `list-cron-events`, `get-plugin-dependencies`, `list-post-types`, `list-taxonomies`, `list-terms`, `report-term-usage`, `list-navigation-menus`, `list-block-patterns`, `list-site-templates` | Up to 6 |
| **Site researcher** (`researcher`) | Helper that gathers read-only site information and returns a short summary to the Assistant. | `core/*` plus `maze-graph/content-summary`, `get-content`, `list-post-types`, `list-terms`, `search-content`, `recall-notes` | Up to 4 |

The Assistant's default list is an allowlist, not a grant of access. Each tool must also be enabled, available to the current WordPress user, and allowed by MazeGraph's policy. An administrator can broaden the built-in Assistant's scope in [Settings → Tools](/docs/settings/tools/), but this does not change the other agents' scopes or bypass those checks.

## Site and plugin agents

The list can also contain agents supplied by the site, a plugin, or the active theme. Site-owned agents are represented as JSON definitions and can be reviewed in [Extensions](/docs/tools/extensions/). Plugin and theme agents are managed by their provider. Only agents enabled and available in the current catalogue can be selected or called.

The `*` tool pattern means all tools that the agent's other access checks permit. A pattern such as `core/*` matches tools in that namespace. The pattern never bypasses the tool's own switch, the user's WordPress capabilities, or site policy.

For custom agent definitions and developer integration points, see the [developer reference](https://developers.mazegraph.com/).

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