OceanWP
These abilities register when OceanWP is detected on the site and a Pro licence is active. If either is missing the module stays absent rather than failing at call time.
At a glance
OceanWP registers 15 abilities: 6 that only read, 9 that write, and 0 marked destructive. That split is the practical answer to how much of this module can run unattended. Reads cost nothing and are safe to repeat, so discovery is the part to be generous with; the writes are where review belongs, and the destructive calls stop for an explicit confirmation every single time regardless of which profile is active.
What this module is for
Use AI clients to inspect OceanWP settings and operate modules, Customizer panels, headers, page overrides, library templates, and WooCommerce theme features.
Before you rely on it: Page overrides may mask global settings, so audit both layers before deciding an edit failed.
Typical workflows
- Audit page overrides before changing a global header
- Enable only the module a workflow needs
- Apply a library template after checking layout dependencies
The OceanWP integration page covers the same module from the workflow side, with the capability map and the questions worth asking before a first write.
Availability on your site
The OceanWP module needs three things at once: WPPilot Free as the MCP foundation, an active Pro licence, and the companion plugin detected on the site. Miss any one and the module does not register, which is deliberate: an ability that appears in the tool list but fails at call time is worse than an ability that was never offered. What the connected agent can actually call is then narrowed twice more: by the safety profile active on the site, and by the WordPress capabilities of the user behind the credential. A read that succeeds for an administrator can be absent entirely for an editor.
Every write these abilities perform is recorded in the change ledger, and destructive calls can be routed through the approval queue so a person signs off before anything is applied. A successful tool result means the operation returned, not that the front end, the cache, and every dependent template are correct: that still needs a look.
Reads
Available in every safety profile, including Read Only. Inspection costs nothing and is not rate limited.
| Ability | What it does |
|---|---|
wppilot/oceanwp-get-page-overridesGet OceanWP Per-Page Overrides | Reads the agent-curated allowlist of ocean_* postmeta override keys on a single post. Each entry reports whether the override is actually set on the post (is_set: true means the post overrides the global default) or whether the post inherits the global. Returns the meta value when set, null otherwise. Filter to a specific subset with fields: [...]. For meta keys outside the allowlist use wppilot/execute-php with get_post_meta($post_id, "ocean_<key>", true). |
wppilot/oceanwp-get-settingsGet OceanWP Customizer Settings | Reads the live value of OceanWP Customizer settings from the agent-curated allowlist. By default returns the full allowlist; pass panel to filter to one subdomain or settings: [...] to fetch specific keys. Typography settings (font-family / font-weight / font-size / line-height / letter-spacing) are returned as decoded objects. Settings outside the allowlist are intentionally NOT returned by this ability — for ad-hoc reads of OceanWP theme_mods use wppilot/execute-php with get_theme_mod( "ocean_<key>" ). |
wppilot/oceanwp-list-customizer-panelsList OceanWP Customizer Panels | Returns the static catalogue of OceanWP Customizer panels (typography, colors, general, header, blog, WooCommerce, …). Each entry reports the panel id, label, approximate settings count, a one-line description, the integration that must be active for the panel to apply (when conditional), and a resolved active flag based on the current install. Use this to discover which subdomain to target with oceanwp-get-settings (and Sprint-2 oceanwp-set-* abilities). |
wppilot/oceanwp-list-hooksList OceanWP Render Hooks | Returns the agent-curated catalogue of ocean_* action and filter hooks the theme exposes at render time (layout wrap, header, top bar, page header, main, content, footer, scroll-up). Use the returned hook names with wppilot/execute-php snippets: add_action() to inject HTML/template at action hooks, add_filter() (often with __return_false / __return_true) to suppress or override layout regions. The full ~470 ocean_* hook surface lives in the theme source — this catalogue is the high-leverage subset. |
wppilot/oceanwp-list-library-itemsList OceanWP Library Items | Lists the Ocean Extra oceanwp_library CPT posts — the reusable header / footer / topbar / 404 templates the agent can mount via oceanwp-apply-library-template. Returns compact entries (id, title, slug, status, modified). REQUIRES the Ocean Extra companion plugin to be active at the supported version; returns oceanwp_requires_ocean_extra otherwise. Use the limit param to cap the page; defaults to 100, max 500. |
wppilot/oceanwp-list-modulesList Ocean Extra Modules | Lists the Ocean Extra modules an agent can toggle: Sticky Header, Sticky Footer, Side Panel, Popup Login, Footer Callout, Instagram, Cookie Notice, Portfolio, WooCommerce Popup, Full Screen, White Label, Elementor Widgets. Each entry reports the module slug, label, the sentinel PHP class Ocean Extra registers when the module bootstrap has loaded, and the resolved enabled flag (true when the sentinel class exists). REQUIRES Ocean Extra. |
Writes
Gated by the active profile and your WordPress capabilities. Rate limited to 120 per minute per credential.
| Ability | What it does |
|---|---|
wppilot/oceanwp-apply-library-templateApply OceanWP Library Template | Mounts an Ocean Extra Library template (oceanwp_library CPT post) into one of the four customizer-driven slots OceanWP reads at render time: header, topbar, footer_widgets, custom_404. Writes the template id into the matching theme_mod (ocean_header_template / ocean_topbar_template / ocean_footer_widgets_replace / ocean_custom_404_template). The header slot is only effective when the header style is set to custom (see oceanwp-set-header-config). REQUIRES Ocean Extra. |
wppilot/oceanwp-check-setupCheck OceanWP Setup | Returns a structured snapshot of the OceanWP integration state — the theme itself (active, version, minimum supported), the Ocean Extra companion plugin (active, version, minimum supported), the optional third-party integrations OceanWP detects at boot (WooCommerce, Elementor, Beaver Builder, EDD, LearnDash, …), and the set of capability flags the agent can use to decide which sub-ability surfaces are available right now. Call this FIRST before invoking any other oceanwp-* ability. |
wppilot/oceanwp-disable-moduleDisable Ocean Extra Module | Disables one Ocean Extra module by writing false into the matching oceanwp_modules[<slug>] option entry. The actual visible effect takes hold on the next request after Ocean Extra reloads its module manifest. Use oceanwp-list-modules to discover valid slugs. REQUIRES Ocean Extra. |
wppilot/oceanwp-enable-moduleEnable Ocean Extra Module | Enables one Ocean Extra module by writing 1 into the matching oceanwp_modules[<slug>] option entry. The actual visible effect takes hold on the next request after Ocean Extra reloads its module manifest. Use oceanwp-list-modules to discover valid slugs. REQUIRES Ocean Extra. |
wppilot/oceanwp-set-customizer-settingsSet OceanWP Customizer Settings | Partial-merge writer for the agent-curated allowlist of OceanWP Customizer settings (~40 high-leverage theme_mods covering layout, typography, colors, header, blog, footer, performance, WooCommerce features). Pass an object whose keys are theme_mod names and whose values are the new values; any key NOT in the allowlist is rejected in the rejected array without aborting the rest of the write. Values that already match the current theme_mod are reported in unchanged so the agent can tell when a write was a no-op. The whole operation runs inside a per-blog lock so concurrent calls cannot interleave reads/writes against theme_mods_oceanwp. |
wppilot/oceanwp-set-header-configSet OceanWP Header Configuration | Narrow writer for the OceanWP header subdomain: header style (8-value enum — minimal, transparent, top, full_screen, center, medium, vertical, custom), header height in pixels, transparent boolean, and custom_template Library template id (only effective when style is "custom"). Partial merge — pass only the fields you want to change. Same lock + allowlist enforcement as oceanwp-set-customizer-settings. |
wppilot/oceanwp-set-page-overridesSet OceanWP Per-Page Overrides | Writes the agent-curated allowlist of ocean_* postmeta override keys on a single post. Pass overrides as a map of meta-key → value; unknown keys are rejected without aborting the rest. Pre-validates every value against the allowlist BEFORE any persistence (no partial state mutation on rejection). Calls clean_post_cache after each successful write so subsequent reads return the new value. To REMOVE an override (revert to global default), pass null as the value — the post meta key is deleted via delete_post_meta. |
wppilot/oceanwp-set-typography-presetApply OceanWP Typography Preset | Applies a curated typography preset in one call: body typography (ocean_body_typography), headings typography (ocean_headings_typography), primary brand color (ocean_primary_color), and link color (ocean_links_color). Each top-level field is optional — only those passed are written. IMPORTANT: typography fields (body, headings) FULLY REPLACE the existing typography theme_mod — sub-keys you omit are dropped, NOT merged. Read the current typography with oceanwp-get-settings and re-pass every sub-key you want to keep. Typography sub-keys: font-family, font-weight, font-size, font-size-tablet, font-size-mobile, line-height, letter-spacing, text-transform, font-style. |
wppilot/oceanwp-set-woo-featuresSet OceanWP WooCommerce Feature Toggles | Narrow writer for the high-leverage WooCommerce theme_mods OceanWP exposes: off-canvas filter sidebar, distraction-free cart / checkout, quick view modal, floating add-to-cart bar, product hover image-swap, AJAX add-to-cart, menu cart icon style, mobile mini-cart. Requires WooCommerce active (returns oceanwp_requires_woocommerce when WC is inactive). Same lock + pre-validation + alias-aware error messages as oceanwp-set-header-config. |