Tools Reference
Forge ships 18 tools in 4 groups, all read-only (readOnlyHint). Each can be switched off individually on the Tools tab.
| Group | Tools | Risk |
|---|---|---|
| Site introspection | 10 | Low |
| Database read | 3 | Low |
| Content blocks | 2 | Low |
| Memory | 3 | Low |
Site Introspection
| Tool | What it does |
|---|---|
wp_get_site_info | WordPress version, active theme |
wp_list_plugins | Installed plugins and versions |
wp_get_active_theme | Active theme details |
wp_list_hooks | Search registered WordPress hooks |
wp_get_design_authority | Works out whether an active page builder or the theme's design tokens should govern new visual work |
wp_take_screenshot | Screenshot a page |
wp_inspect_page | Static HTML structure of a page |
wp_list_files | Browse files within wp-content |
wp_read_file | Read a text file within wp-content |
wp_list_recent_activity | What this connector has done recently |
wp_take_screenshot requests the screenshot from a public WordPress.com service (s.wordpress.com/mshots), which means the page URL is sent to that service, and the page must be publicly reachable. wp_inspect_page fetches the URL with a server-side request, and only accepts public addresses and the site's own pages, never private or local network addresses. Switch off wp_take_screenshot on the Tools tab if that is not acceptable for your site.
File Access Scope
wp_list_files and wp_read_file are restricted to wp-content (themes, plugins, uploads). Path traversal and symlink escapes are blocked, so files outside it, such as wp-config.php and WordPress core, cannot be read.
Database Read
| Tool | What it does |
|---|---|
wp_db_read | Runs one read-only SELECT statement and returns the rows |
wp_list_tables | Lists database tables |
wp_describe_table | Shows a table's columns |
INSERT, UPDATE, DELETE, and every other non-SELECT statement is rejected. Results are capped by the Max results setting (default 50).
Content Blocks
| Tool | What it does |
|---|---|
wp_get_content_block | Reads one Gutenberg block's full structure (attributes, inner HTML) by position |
wp_list_reusable_blocks | Lists registered reusable blocks (synced patterns) |
Editing a block requires Forge Pro.
Memory
| Tool | What it does |
|---|---|
wp_remember | Saves a fact or note site-wide |
wp_list_memories | Lists saved memories |
wp_forget | Deletes a saved memory |
Memory lets a future, separate conversation recall context such as naming conventions or past decisions. It is plaintext (not a secrets vault) and capped at 200 entries per site.
wp_remember and wp_forget change the plugin's own memory table only. They cannot change your content, files, or site data.