Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
Edit WordPress Theme File
Read and safely edit the ACTIVE THEME's own files on a connected WordPress site — the last resort for things baked into a theme PHP/CSS file that nothing else can reach: a Google tag hard-coded into header.php (a…
- Type
- Makes changes
- Credits
- 1
- Platform
- WordPress
- Approval
- Preview first, applied after you approve
What it does
Read and safely edit the ACTIVE THEME's own files on a connected WordPress site — the last resort for things baked into a theme PHP/CSS file that nothing else can reach: a Google tag hard-coded into header.php (a duplicate gtag the theme prints on every page), a wrong heading level in a template, a stray inline style. wordpress_option reaches plugin/theme SETTINGS and wordpress_snippet adds NEW PHP through WPCode, but neither can change a line the theme itself ships.
action: 'list' = the theme's source files with size and whether each is writable; 'get' (path) = one file's contents; 'edit' (path) = change it; 'restore' (path) = undo the last edit to that file. Scope is narrow: only files INSIDE the active or parent theme folder, only .php/.css/.js/.html/.txt, no path escapes ('..' is refused), and only files that already exist (it never creates one). path is given as list/get reports it, either the full path (wp-content/themes/<theme>/header.php) or just the file name (header.php). edit has two modes. mode='remove_block' with contains='<text>' removes every <script>/<noscript> block that contains that text, which strips a hard-coded gtag / GTM / Google Ads tag out of a theme file (wordpress_tracking detects AW- / G- / GT- ids in theme files too). mode='replace' with find + replace makes a literal text change; count caps how many occurrences may match, and if find appears more times than that nothing is written, so a more specific find is needed; this is how an H4 becomes an H2. SAFETY on every edit: the whole file is backed up first, PHP files are re-checked with `php -l` and the write is AUTOMATICALLY REVERTED if it would break the syntax, and restore brings the previous version back. confirm=false previews (match count and size delta) without writing; confirm=true applies. Needs Connector 0.9.0 or newer.
MCP: wordpress_theme_file
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| action | string | Optional | list | list · get · edit · restore · Requested action for the selected resource; choose one of the actions allowed by this schema. |
| path | string | Optional | · | Provider path, route, or resource-relative path to use for this operation. |
| find | string | Optional | · | Exact find value for wordpress theme file. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| replace | string | Optional | · | Replacement text or structured replacement rule to apply when this operation supports replacement. |
| contains | string | Optional | · | Exact contains value for wordpress theme file. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| mode | string | Optional | replace | Behaviour mode for this operation. Use one of the supported modes documented by the tool. |
| count | integer | Optional | 0 | Numeric count value for wordpress theme file. Use the provider's expected unit, range, and precision. |
| confirm | boolean | Optional | false | Safety confirmation for a state-changing operation. Leave false to preview or validate; set true only after the user explicitly approves the shown change. |
| site_url | string | Optional | · | Exact URL of the connected WordPress site to target when more than one site is available. |
Related tools
list_wordpress_sitesBulk Find & Replace (WordPress)wordpress_bulk_replaceWordPress WP-CLI Commandwordpress_cliList WordPress Contact Formswordpress_contact_formsWordPress Core Info Fileswordpress_core_filesCreate WordPress Postwordpress_create_postWordPress Critical CSS (status / regenerate)wordpress_critical_cssEdit WordPress Menuwordpress_edit_menuEdit WordPress Page Designwordpress_edit_page_design