Build a saved-query type as two coordinated components: a runtime query and an\nadmin editor. Keep the runtime authoritative; editor controls, REST inputs,\nfilters, and MCP-created settings are all untrusted input to that runtime.
\nUse the same vendor-prefixed slug in both registrations.
\nadd_action(\n 'jet-engine/query-builder/queries/register',\n static function($factory): void {\n require_once __DIR__ . '/src/class-my-plugin-query.php';\n $factory::register_query('my-plugin-records', My_Plugin_Query::class);\n }\n);\n\nadd_action(\n 'jet-engine/query-builder/query-editor/register',\n static function($editor): void {\n require_once __DIR__ . '/src/class-my-plugin-query-editor.php';\n $editor->register_type(new My_Plugin_Query_Editor());\n }\n);\nThe runtime base has six required methods in 3.8.14:
\n_get_items()\nget_items_total_count()\nget_items_page_count()\nget_items_pages_count()\nget_current_items_page()\nset_filtered_prop($prop = '', $value = null)\nOmitting set_filtered_prop() leaves the subclass abstract and causes a fatal\nwhen JetEngine instantiates it.
use Jet_Engine\\Query_Builder\\Queries\\Base_Query;\n\nfinal class My_Plugin_Query extends Base_Query {\n private function args(): array {\n $this->setup_query();\n $args = $this->get_query_args();\n\n return array(\n 'status' => sanitize_key($args['status'] ?? 'active'),\n 'page' => max(1, absint($args['page'] ?? 1)),\n 'per_page' => min(100, max(1, absint($args['per_page'] ?? 20))),\n );\n }\n\n public function _get_items() {\n return my_plugin_repository()->find($this->args());\n }\n\n public function get_items_total_count() {\n $cached = $this->get_cached_data('count');\n if (false !== $cached) {\n return (int) $cached;\n }\n\n $count = (int) my_plugin_repository()->count($this->args());\n $this->update_query_cache($count, 'count');\n return $count;\n }\n\n public function get_items_per_page() {\n return $this->args()['per_page'];\n }\n\n public function get_current_items_page() {\n return $this->args()['page'];\n }\n\n public function get_items_pages_count() {\n return max(1, (int) ceil(\n $this->get_items_total_count() / $this->get_items_per_page()\n ));\n }\n\n public function get_items_page_count() {\n return count($this->get_items());\n }\n\n public function set_filtered_prop($prop = '', $value = null) {\n if ('_page' === $prop) {\n $this->final_query['page'] = max(1, absint($value));\n return;\n }\n\n $this->merge_default_props($prop, $value);\n }\n}\nBase_Query::get_items() automatically reads and writes the item cache. Do not\nduplicate item caching in _get_items(). Counts and auxiliary requests need\ntheir own keys. Always test cache lookup with false !== $cached, because zero\nand an empty array are valid cached values.
Call setup_query() or get_query_args() before reading final arguments. It:
_id-addressed nested groups;get_args_to_explode();_query_type and queried_object_id.Do not read $this->query as the executable query, and do not call\nmerge_dynamic_nested_args() on the entire final query. That helper accepts a\nsingle nested group with an args member; setup_query() invokes it correctly.
In set_filtered_prop(), validate each property and preserve restrictions.\nIntersect allowlists/IDs when a filter must narrow the base query. Blindly\nreplacing a tenant, owner, status, or visibility restriction can expose data.
cache_expires for external or frequently changing data.reset_query()/query_was_changed() if the class holds an inner\nquery object or mutable state beyond final_query.The editor subclass must at least implement get_id() and get_name(). Return\na component name/template/file only if custom controls are required. JetEngine\nenqueues editor component files with an empty dependency array; ensure required\nglobals are already provided by the Query Builder page, or enqueue a separate\ndependency-aware bundle.
Saved Query Builder queries can opt into a REST endpoint. The type must still\nsanitize every runtime argument and preserve access constraints; endpoint\npermission comes from the saved query's access settings, not the custom class.
\nJetEngine's MCP add-query tool lists registered custom type slugs, but it does\nnot understand their arguments automatically. Without a converter,\nconverted_args is empty and the saved type-specific settings may be empty.\nFor intentional MCP support:
mcp_description() for schema guidance; andjet-engine/query-builder/mcp/get-converter/my-plugin-records.This MCP feature creates saved queries; it does not turn every saved query into\nan independently callable MCP tool.
\nRead runtime-editor-mcp.md when building the\neditor UI, filter semantics, REST exposure, or MCP conversion.
\nTest empty results, cached empty results, zero count, two pages, final partial\npage, out-of-range page, filter narrowing, attempted restriction widening,\nmacro changes, two identical cached calls, mutation invalidation, editor save /\nreload, and REST permissions if enabled. For MCP support, create a query and\ninspect the persisted type-specific settings rather than only the returned ID.
\nwp-content/plugins/jet-engine/includes/components/query-builder/queries/base.phpwp-content/plugins/jet-engine/includes/components/query-builder/query-factory.phpwp-content/plugins/jet-engine/includes/components/query-builder/query-editor.phpwp-content/plugins/jet-engine/includes/components/query-builder/editor/base.phpwp-content/plugins/jet-engine/includes/components/query-builder/rest-api/query-endpoint.phpwp-content/plugins/jet-engine/includes/components/query-builder/mcp/controller.phpwp-content/plugins/jet-engine/includes/components/query-builder/mcp/tool-add-query.php