Smart MCP 1.1.0 has 11 actions and 24 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 Smart MCP fires an action
add_action( 'smartmcp_mcp_set_full_access', function( $arg1 ) {
// Your code runs here.
}, 10, 1 );
// Change a value Smart MCP is about to use
add_filter( 'smartmcp_admin_header_actions', function( $value, $slug ) {
// Change $value here.
return $value;
}, 10, 2 );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
-
/** * Turns an add-on's full access on or off. */ do_action( 'smartmcp_mcp_set_full_access', 'full' === $mode ); -
/** * Filters the action links shown on the right of the header. */ apply_filters( 'smartmcp_admin_header_actions', array(), $slug ); -
/** * Filters the Smart MCP screens that show the global header. */ apply_filters( 'smartmcp_admin_header_pages', $pages ); -
/** * Filters what this connection can do beyond the tools list, so the agent does * not assume a capability exists when it does not. */ apply_filters( 'smartmcp_agent_capabilities', array( 'edit_existing_elementor_pages' => did_action( 'elementor/loaded' ) && $offered( 'elementor_page_build' ), 'elementor_diagnostics' => did_action( 'elementor/loaded' ) && $offered( 'elementor_page_settings' ), 'elementor_v4_design' => \SmartMCP\Services\Elementor_Props::available() && $offered( 'elementor_design' ), 'undo_conversation' => $offered( 'undo_changes' ), 'safe_edit_live_pages'... ); -
/** * Filters the extensions accepted by the upload endpoint. */ apply_filters( 'smartmcp_allowed_upload_extensions', self::ALLOWED_EXTENSIONS ); -
/** * Filters how many tokens of earlier conversation a messaging channel sends to * the AI. About four characters make one token. */ apply_filters( 'smartmcp_channel_history_tokens', 24000 ); -
/** * Extension point for third-party plugins to register their own messaging * channels. */ do_action( 'smartmcp_channels_register', $registry ); -
/** * Fires after the built-in authentication method cards on the Connect page. * Extensions can add a `.smartmcp-method-card` here. */ do_action( 'smartmcp_connect_auth_cards' ); -
/** * Filters the Authorization header used in a client config snippet. */ apply_filters( 'smartmcp_connect_auth_header', 'Bearer __SMARTMCP_KEY__', $mode, $this->get_id() ); -
/** * Filters the auth modes offered on the Connect page. */ apply_filters( 'smartmcp_connect_auth_modes', array( 'key', 'oauth' ) ); -
/** * Extension point for third-party plugins to register their own AI client * definitions for the Connect page. */ apply_filters( 'smartmcp_connect_clients', $this->clients ); -
/** * Fires after the built-in credential panes on the Connect page. Extensions * can add a matching `.smcp-credential-pane` here. */ do_action( 'smartmcp_connect_credential_panes' ); -
/** * Fires after the built-in credential tabs on the Connect page. Extensions can * add a `.smcp-credential-tab` button here. */ do_action( 'smartmcp_connect_credential_tabs' ); -
/** * Fires on the More settings tab of the Connect page, for add-on settings that * most sites do not need (for example Cloudflare). */ do_action( 'smartmcp_connect_page_more' ); -
/** * Fires after "What can AI apps do on this site?" on the Permissions tab, for * add-ons that offer settings for external AI clients. */ do_action( 'smartmcp_connect_page_sections' ); -
/** * Filters how many days inactive conversations are kept. 0 keeps them. */ apply_filters( 'smartmcp_conversation_retention_days', 0 ); -
/** * Filters whether an external client acting as an administrator may use a * tool. */ apply_filters( 'smartmcp_external_admin_tool_allowed', $allowed, $tool, $user ); -
/** * Filters the user id for an external credential the free plugin does not * handle itself. Return a user id greater than 0 to authenticate the request * as that user. */ apply_filters( 'smartmcp_mcp_authenticate', 0, $authorization ); -
/** * Filters the client IP used for MCP rate limits (for other proxies). */ apply_filters( 'smartmcp_mcp_client_ip', $ip, $remote ); -
/** * Filters whether AI clients have full (administrator) access through an * add-on. Return null when no add-on offers it. */ apply_filters( 'smartmcp_mcp_full_access', null ); -
/** * Filters how many failed sign-ins one IP may make in five minutes. */ apply_filters( 'smartmcp_mcp_max_failed_auth', 30 ); -
/** * Filters the requests one credential may send per minute (object cache only). */ apply_filters( 'smartmcp_mcp_requests_per_minute', 600 ); -
/** * Configure which admin page Smart MCP should take over. */ apply_filters( 'smartmcp_override_admin_page', $default ); -
/** * Filters the address of the "Test from the internet" service. */ apply_filters( 'smartmcp_reach_test_service', 'https://wpsmarto.com/api/smart-mcp/reach-test' ); -
/** * Fires after the settings, for add-ons that offer settings for the Chat page * and Telegram. */ do_action( 'smartmcp_settings_page_sections' ); -
/** * Extra sections at the end of the Telegram Bot page. */ do_action( 'smartmcp_telegram_page_sections' ); -
/** * Filters whether a tool is available in a channel. */ apply_filters( 'smartmcp_tool_available', $available, $tool, $channel ?? $this->channel ); -
/** * Extension point for third-party plugins to register their own MCP tools. */ do_action( 'smartmcp_tools_register', $registry ); -
/** * This filter is documented in wp-admin/includes/ajax-actions.php */ apply_filters( 'wp_check_post_lock_window', 150 ); -
apply_filters( 'smartmcp_provider_timeout', 120, $this->get_id() ); -
apply_filters( 'smartmcp_chat_context', $prompt ); -
do_action( 'elementor/atomic-widgets/styles/clear', array( 'local', (int) $post_id ) ); -
apply_filters( 'smartmcp_mcp_external_user_id', $default, $authenticated_id ); -
apply_filters( 'smartmcp_telegram_dispatch', false, $this, $chat_id, $text, $wp_user ); -
apply_filters( 'smartmcp_telegram_runs_in_background', false );
Generated from Smart MCP'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: