QuangNhatDev AI Agent Tools for WebMCP

Description

QuangNhatDev AI Agent Tools for WebMCP helps WordPress sites expose structured, read-only capabilities to compatible browser AI agents through WebMCP.

Instead of forcing an agent to infer site behavior from page layouts, buttons, menus, or product cards, the plugin registers clearly defined tools through the browser document.modelContext API.

The plugin is designed to fail safely. If WebMCP is unavailable in a visitor’s browser, the normal WordPress site continues to work unchanged.

Why use it?

• Native WebMCP integration based on document.modelContext.
• Built-in browser and server diagnostics.
• Live WebMCP Tool Tester inside WordPress admin.
• WordPress content, navigation, taxonomy, and site-information tools.
• WooCommerce product search and product detail tools when WooCommerce is active.
• Public custom post type support.
• Per-tool enable and disable controls.
• Same-origin REST endpoints.
• Local rate limiting with salted identifiers.
• Read-only tools by default.
• No telemetry, analytics, cloud account, or mandatory external service.

Included tools

WordPress tools:

• wp_search_content – Search published posts, pages, and enabled public custom post types.
• wp_get_content – Read one published content item by ID, URL, slug, or path.
• wp_get_navigation – Read public navigation menus and menu locations.
• wp_get_taxonomies – List public taxonomies or terms from one taxonomy.
• wp_get_site_info – Read non-sensitive public site information.

WooCommerce tools, available when WooCommerce is active:

• woo_search_products – Search visible published WooCommerce products.
• woo_get_product – Read one visible published WooCommerce product.

Privacy-first by design

The built-in tools are intentionally limited to public, read-only information.

The plugin does not expose:

• Drafts or private posts.
• Password-protected content.
• WordPress users.
• WooCommerce customers or orders.
• Payment information.
• Arbitrary post metadata.
• Administrative write actions.
• Cart, checkout, coupon, payment, or form-submission actions.

All built-in tools use readOnlyHint: true. Content-returning tools also use untrustedContentHint: true.

Diagnostics and testing

The Diagnostics screen helps administrators verify:

• Plugin, WordPress, and PHP versions.
• HTTPS availability.
• WebMCP master-switch status.
• Browser Origin Trial token configuration.
• REST API base URL.
• WooCommerce integration status.
• document.modelContext availability.
• registerTool(), getTools(), and executeTool() availability.
• Tools currently registered in the document.

The Live Tool Tester discovers browser-registered tools and executes them directly from WordPress admin, making it easier to inspect tool inputs and structured outputs without manually writing JavaScript in DevTools.

Browser support

WebMCP is an experimental and evolving web-platform technology. Browser support and API behavior may change over time.

The plugin checks for WebMCP support before registering tools and degrades safely when the API is unavailable.

An optional field is provided for a first-party browser Origin Trial token when required by the browser implementation. The token is issued by the browser vendor and does not unlock or restrict plugin functionality.

This plugin is independently developed and is not an official Google, Chrome, WooCommerce, or WordPress product.

Privacy

This plugin stores its settings in the WordPress options table.

For local REST rate limiting, it stores short-lived transients keyed by a salted hash. The plugin does not intentionally store raw IP addresses, create visitor profiles, send telemetry, or contact external services.

When the plugin is deleted through WordPress, its main settings option is removed by uninstall.php. Short-lived rate-limit transients expire automatically.

Developer Notes

Filter built-in tool definitions with:

qnatw_tool_definitions

Filter selected response data with:

• qnatw_search_content_result
• qnatw_get_content_result
• qnatw_get_navigation_result
• qnatw_get_taxonomies_result
• qnatw_get_site_info_result
• qnatw_search_products_result
• qnatw_get_product_result
• qnatw_manifest

The plugin intentionally does not provide an arbitrary PHP or JavaScript editor.