GripMCP 1.0.1 has 20 actions and 56 filters, read directly from its source code on Nov 19, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when GripMCP fires an action
add_action( 'gripmcp/settings_saved', function( $arg1 ) {
// Your code runs here.
}, 10, 1 );
// Change a value GripMCP is about to use
add_filter( 'gripmcp/abilities_denylist', function( $value ) {
// Change $value here.
return $value;
}, 10, 1 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
All hooks
-
/** * Fires after the settings screen is saved. */ do_action( 'gripmcp/settings_saved', $this->settings->all() ); -
/** * Fires after every MCP tool call, successful or not. */ do_action( 'gripmcp/tool_called', $group, $status, $duration ); -
/** * This action is documented in includes/Protocol/Server.php (record_call). */ do_action( 'gripmcp/tool_error', $method, 'internal_exception', $e->getMessage(), $e ); -
/** * Filter the ability names GripMCP refuses to list or run. */ apply_filters( 'gripmcp/abilities_denylist', array( 'gripmcp/*' ) ); -
/** * Filter what an ability is read as declaring about itself, before GripMCP * decides whether running it is destructive. Each value is true, false, or * null for "not said"; anything else counts as null. Use it to vouch for an * ability its plugin left unannotated, or to mark one destructive. */ apply_filters( 'gripmcp/ability_annotations', $flags, self::name( $ability ), $ability ); -
/** * Filter the abilities GripMCP treats as running another ability. Use it to * add a wrapper another plugin registers; the ones listed here always stay, * with their own keys. */ apply_filters( 'gripmcp/ability_wrappers', $wrappers ); -
/** * Prints the full audit log on the Activity tab. The paid version hooks it on * the plans that include it. */ do_action( 'gripmcp/admin/audit_log', ! empty( $settings['logging_enabled'] ) ); -
/** * Filter how a held call is described to the person deciding on it. */ apply_filters( 'gripmcp/approval_action', $action, $tool_name, $arguments ); -
/** * Filter the capability required to approve a held call. */ apply_filters( 'gripmcp/approval_capability', $capability, (string) ( $request['tool'] ?? '' ), $request ); -
/** * Fires when a held tool call is approved or declined. */ do_action( 'gripmcp/approval_decided', $approval_id, $decision, (string) ( $request['tool'] ?? '' ), get_current_user_id() ); -
/** * Fires after an approved call has run. */ do_action( 'gripmcp/approval_executed', $name, (int) ( $request['decided_by'] ?? 0 ), (int) ( $request['user_id'] ?? 0 ) ); -
/** * Fires on a failed authentication attempt against the MCP endpoint. */ do_action( 'gripmcp/auth_failure' ); -
/** * Filter the list of MCP authentication providers. */ apply_filters( 'gripmcp/auth_providers', $providers ); -
/** * Final authorization gate. Return a WP_Error to deny (e.g. IP allowlist or * per-user policy from a premium module). */ apply_filters( 'gripmcp/authorize', true, $request ); -
/** * Fires when a request is refused at the endpoint gate. */ do_action( 'gripmcp/blocked', 'https_required' ); -
/** * Fires after the plugin has registered its services and hooks. */ do_action( 'gripmcp/booted', $this, $this->container ); -
/** * Filter how wp_capabilities_check describes itself to the assistant. The paid * version names what its report adds. */ apply_filters( 'gripmcp/capabilities_description', $description ); -
/** * Filter wp_capabilities_check's report. The paid version adds its tools' * permissions, why any of them is blocked, the switched-on groups its plan has * no tools for, and what each plan above the site's adds. */ apply_filters( 'gripmcp/capabilities_report', $report, $context, $this->settings, $this->packages, $this->registry ); -
/** * Filter: more post types holding code that another plugin runs on the site. * GripMCP then reads their posts but does not create, change, restore or * delete them, unless the site's plan changes code. */ apply_filters( 'gripmcp/code_post_types', array() ); -
/** * Filter the impact report for a held call. */ apply_filters( 'gripmcp/impact_check', $report, $tool_name, $arguments ); -
/** * Filters whether in-chat uploads are offered. Return false to leave the * upload tools and panel out; takes effect when an assistant next connects. */ apply_filters( 'gripmcp/in_chat_uploads', true ); -
/** * Filter whether an option is protected from MCP access. */ apply_filters( 'gripmcp/is_protected_option', false, $name ); -
/** * Filters how many days of activity log are kept. */ apply_filters( 'gripmcp/log_retention_days', $days ); -
/** * Filter the extensions refused for files added through MCP. */ apply_filters( 'gripmcp/media_blocked_extensions', self::BLOCKED_EXTENSIONS ); -
/** * Filter the byte ceiling for media uploaded through MCP. */ apply_filters( 'gripmcp/media_max_upload_bytes', $max ); -
/** * Filters whether new apps may register for one-click connect. */ apply_filters( 'gripmcp/oauth_allow_dcr', (bool) $this->get( 'oauth_allow_dcr', true ) ); -
/** * Filter whether wp_page_html verifies this site's SSL certificate. */ apply_filters( 'gripmcp/page_html_sslverify', $verify, $url ); -
/** * The literal command or request of a paid plan's WP-CLI or REST call, which * the paid version describes. */ apply_filters( 'gripmcp/paid_action_fallback', null, $tool_name, $arguments ); -
/** * The sentences for a paid plan's tool (WP-CLI, the REST API, plugins, themes, * files, page builders, refunds), which the paid version describes. Null when * nothing describes the call. */ apply_filters( 'gripmcp/paid_action_sentences', null, $tool_name, $arguments ); -
/** * How a paid plan's WP-CLI or REST call is sent, which the paid version * describes. */ apply_filters( 'gripmcp/paid_action_via', '', $tool_name, $arguments ); -
/** * Check a call to a paid plan's tool (plugins, themes, files, search and * replace, page builders, the REST API), which the paid version does, adding * its findings to this report. */ apply_filters( 'gripmcp/paid_impact_check', false, $check_tool, $check_args, $context ); -
/** * The tool call a paid plan's WP-CLI command or REST request amounts to, which * the paid version works out. */ apply_filters( 'gripmcp/paid_impact_equivalent', null, $tool_name, $arguments ); -
/** * Filter what the settings screen and wp_capabilities_check say a plan * includes or adds. */ apply_filters( 'gripmcp/plan_highlights', self::base_highlights( $plan ), $plan ); -
/** * Filter the line under a plan's name on the Upgrade page. The plugin from * WordPress.org describes only Explorer, and leaves the paid plans to the plan * cards below; the paid version describes each. */ apply_filters( 'gripmcp/plan_line', $line, $plan ); -
/** * Filters whether progress cards are offered. Return false to leave them out: * the card tools and their instructions are then not sent to clients, which * takes effect when an assistant next connects. */ apply_filters( 'gripmcp/progress_cards', $enabled ); -
/** * Fires after GripMCP made a site-wide change cache plugins cannot see, so a * host or a cache plugin not covered here can purge. */ do_action( 'gripmcp/purge_all' ); -
/** * Fires after GripMCP changed a post in a way cache plugins cannot see, so a * host or a cache plugin not covered here can purge it. */ do_action( 'gripmcp/purge_post', $post_id ); -
/** * Filter how many requests one user may send to the MCP endpoint in a minute. * The ceiling is not on the settings screen; this is the way to change it. */ apply_filters( 'gripmcp/rate_limit', $this->settings->rate_limit(), $user_id ); -
/** * Last-resort override for hosts that expose the scheme in some other way * entirely. */ apply_filters( 'gripmcp/request_is_https', false ); -
/** * Filter whether a tool call needs human approval. */ apply_filters( 'gripmcp/requires_approval', $required, $tool->get_name(), $tool, $arguments ); -
/** * Filter the map of custom RPC method handlers. */ apply_filters( 'gripmcp/rpc_methods', array() ); -
/** * Filter the serverInfo block returned to clients. */ apply_filters( 'gripmcp/server_info', $server_info, $version ); -
/** * Filter the tool groups the screen lists: each group's name and a line on * what it holds, by group id, in the order shown. The paid version adds its * own groups and describes them for the site's plan. */ apply_filters( 'gripmcp/settings_groups', $core_groups, $gripmcp_plan ); -
/** * Filter what the settings screen says about the rules for the assistant and * the card of switches under them, as above. */ apply_filters( 'gripmcp/settings_screen_text', $gripmcp_text, $advanced_open ); -
/** * Filter the short MCP endpoint path. */ apply_filters( 'gripmcp/short_endpoint_path', $path ); -
/** * Filters the address problem reports are addressed to, for a site that * resells or supports GripMCP itself. */ apply_filters( 'gripmcp/support_email', self::SUPPORT_EMAIL ); -
/** * Filter the report's list of settings changed from their defaults, so far. * The paid version adds its switches; the plugin from WordPress.org has none. */ apply_filters( 'gripmcp/support_report_settings', $changed, $s ); -
/** * Filters the examples of requests that get a progress card. */ apply_filters( 'gripmcp/task_examples', $examples ); -
/** * Filter the registered MCP tools. */ apply_filters( 'gripmcp/tools', $defaults, $this ); -
/** * Filter the list of UI widget resources advertised to clients. */ apply_filters( 'gripmcp/ui_widgets', $widgets ); -
/** * Filters whether an account may use GripMCP. */ apply_filters( 'gripmcp/user_may_connect', $allowed, $user ); -
/** * Filters a widget's HTML before it is served. The URI it is offered under * carries a hash of the result (versioned()), so a changed page reaches the * host under a new address. */ apply_filters( 'gripmcp/widget_html', $html, $base ); -
/** * This filter is documented in wp-includes/http.php */ apply_filters( 'http_request_host_is_external', false, $host, $url ); -
/** * This filter is documented in wp-admin/includes/post.php */ apply_filters( 'wp_check_post_lock_window', 150 ); -
do_action( 'breeze_clear_all_cache' ); -
do_action( 'gripmcp_fs_loaded' ); -
do_action( 'gripmcp/activated' ); -
apply_filters( 'gripmcp/auth_failure_limit', self::AUTH_FAILURE_LIMIT ); -
apply_filters( 'gripmcp/capabilities', $base_capabilities ); -
do_action( 'gripmcp/deactivated' ); -
apply_filters( 'gripmcp/instructions', $this->instructions( $ui ) ); -
apply_filters( 'gripmcp/oauth_access_ttl', self::ACCESS_TTL ); -
apply_filters( 'gripmcp/oauth_dcr_rate_global', self::RATE_GLOBAL ); -
apply_filters( 'gripmcp/oauth_dcr_rate_per_ip', self::RATE_PER_IP ); -
apply_filters( 'gripmcp/oauth_logging', true ); -
apply_filters( 'gripmcp/oauth_max_clients', self::MAX_CLIENTS ); -
apply_filters( 'gripmcp/oauth_max_pending_clients', self::MAX_PENDING_CLIENTS ); -
apply_filters( 'gripmcp/oauth_refresh_ttl', self::REFRESH_TTL ); -
apply_filters( 'gripmcp/oauth_rotation_grace', self::ROTATION_GRACE ); -
apply_filters( 'gripmcp/plan_switches', array() ); -
do_action( 'litespeed_purge_all' ); -
do_action( 'litespeed_purge_post', $post_id ); -
apply_filters( 'post_types_to_delete_with_user', $types, $id ); -
do_action( 'rt_nginx_helper_purge_all' ); -
do_action( 'wpfc_clear_all_cache' ); -
do_action( 'wpfc_clear_post_cache_by_id', false, $post_id );
Generated from GripMCP's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Done for you
Rather have it built for you?
Tell us what should change and we’ll write and test the code using these hooks.
Custom hook snippet
from $49
A small, update-safe change built on the plugin’s own hooks.
- Code written against the plugin’s actions and filters
- Tested on a staging copy of your site
- Install instructions included
Typical turnaround: 2–3 business days
Choose thisPlugin customisation
from $149
New features or changed behaviour, without editing the plugin’s files.
- Built as a companion plugin, so updates never wipe it
- Exact quote before we start
- Tested on staging, then deployed
Typical turnaround: 3–7 business days
Choose thisNot sure which fits? Describe what you need and we’ll suggest the simplest option.
Can't find the right hook?
We can build the customisation for you. Describe what you need: