Documentation
Forge
Overview

WindCodex Forge

Overview

WindCodex Forge gives Claude, ChatGPT, and other MCP-compatible AI assistants a small set of general-purpose, read-only tools for understanding a WordPress site: installed plugins, the active theme, registered hooks, files inside wp-content, database structure and data (SELECT only), Gutenberg blocks, and cross-conversation memory.

Forge is entirely free, needs no license key, and has no write tool and no code-execution capability. That is not a setting to be careful with: it is not present in the code. Every tool is tagged readOnlyHint.

AI platform (Claude, ChatGPT, any MCP client)
        │  OAuth 2.0
        ▼
┌------------------------------------------------┐
│  /wp-json/windcodex-forge/v1/mcp               │
│  ├── Rate limit (120 requests/min per user)    │
│  └── 18 read-only tools in 4 groups            │
└--------------------┬---------------------------┘
                     ▼
   plugins · theme · hooks · wp-content files
   database (SELECT only) · blocks · memory

Forge is one of two WindCodex AI product lines. Ops runs a fixed list of safe actions on live sites. Forge is for developers who need an AI to inspect code (this plugin) or write and run it (Forge Pro, for staging sites).


Requirements

RequirementMinimumNotes
WordPress6.0Tested up to 7.1
PHP7.4-
AI platformAny MCP clientClaude, ChatGPT, or similar
License key / accountNot neededFree plugin

Key Features

  • Site introspection - plugins, active theme, registered hooks, screenshots, static page inspection, recent connector activity, and design-authority detection.
  • File read - browse and read files inside wp-content (themes, plugins, uploads).
  • Database read - arbitrary SELECT queries, table listing, and schema introspection.
  • Content blocks (read-only) - read a Gutenberg block's structure by position and list reusable blocks.
  • Memory - save notes that a future, separate conversation can recall.
  • Revocable OAuth access, WordPress Abilities API support, and a rate limit.

See the Tools Reference for all 18 tools.


Free vs. Pro Comparison

FeatureForge (Free)Forge Pro
Tools / groups18 / 439 / 9
Site introspection✅ 10 tools✅ 11 tools (adds snapshot listing)
File read (wp-content)✅✅
Database read✅✅
Content blocksRead onlyRead and write
Memory✅✅
Execute PHP✗✅
Run WP-CLI (foreground and background)✗✅
Sandbox file writes✗✅
Direct file writes✗✅
Database write✗✅
Pre-write snapshots and restore✗✅
Production-site detection and power-tool lock✗✅
Safe on a live site✅✗ Meant for staging
Automatic updates and support✗✅

Where to Go Next