README

MCP server for WordPress + Bedrock + Acorn + Sage.
Gives AI assistants deep context about your Roots stack.

Quick Start

composer require digitalnodecom/substrate --dev
wp acorn substrate:install

The install wizard configures MCP for your IDE and generates project guidelines.

Requirements

PHP 8.2+
WordPress 6.0+
Acorn 5.0+

Usage

# Start MCP server (usually handled by your IDE)
wp acorn substrate:mcp

# Refresh caches after plugin/theme changes
wp acorn substrate:update

MCP Configuration

The installer creates .mcp.json automatically. Manual setup:

{
  "mcpServers": {
    "substrate": {
      "command": "php",
      "args": ["vendor/bin/acorn", "substrate:mcp"]
    }
  }
}

Tools

31 tools across three categories:

Core (10)

Tool	Description
`ApplicationInfo`	PHP, WordPress, Acorn versions, theme info, plugins, packages
`BrowserLogs`	Browser console logs captured by Substrate
`DatabaseConnections`	Configured database connections
`DatabaseQuery`	Execute read-only SQL queries with table prefix support
`DatabaseSchema`	Database schema with WordPress core vs custom table detection
`GetConfig`	Config values from Acorn config, WP options, env vars, constants
`LastError`	Last error/exception from application logs
`ListEnvVars`	Environment variable names from .env files
`ReadLogEntries`	Log entries from debug.log or Acorn logs
`SearchDocs`	Search WordPress, Roots, Tailwind documentation

WordPress (16)

Tool	Description
`AcfFields`	ACF field groups and fields (requires ACF)
`GetOption`	WordPress options by name or pattern
`ListBlocks`	Registered Gutenberg blocks (core and custom)
`ListCronJobs`	Scheduled WP-Cron jobs with next run times
`ListHooks`	Active action/filter hooks with callbacks
`ListMenus`	Navigation menus and menu locations
`ListPlugins`	Installed plugins (active, inactive, must-use)
`ListPostTypes`	Registered post types with configuration
`ListRestRoutes`	REST API endpoints with methods and arguments
`ListShortcodes`	Registered shortcodes with callback info
`ListTaxonomies`	Registered taxonomies
`ListThemes`	Installed themes with parent/child relationships
`ListTransients`	Database transients with expiration times
`ListUsers`	User roles and capabilities
`ListWidgets`	Widgets and sidebars
`WooCommerceInfo`	Store info, settings, gateways (requires WooCommerce)

Acorn/Sage (5)

Tool	Description
`ListAssets`	Assets from Vite manifest
`ListBladeComponents`	Blade components (anonymous and class-based)
`ListServiceProviders`	Acorn service providers
`ListViewComposers`	View composers with their target views
`SageInfo`	Sage theme structure, menus, sidebars, build config

Configuration

wp acorn vendor:publish --tag=substrate-config

// config/substrate.php
return [
    'enabled' => env('SUBSTRATE_ENABLED', true),
    'browser_logs_watcher' => env('SUBSTRATE_BROWSER_LOGS_WATCHER', true),
    'mcp' => [
        'tools' => [
            'include' => [],
            'exclude' => [],
        ],
    ],
];

Browser Console Capture

Substrate captures browser console.log, console.error, etc. for the BrowserLogs tool.

Auto-injected via middleware, or add manually:

@substrateJs
</body>

Development

composer install
composer test      # Run tests
composer lint      # Pint + PHPStan

License

MIT

digitalnodecom / substrate

Maintainers

Details