Documentation

Getting Started

Want to see the complete visitor experience before installing? Try the hosted WordPress Assistants. They work in an ordinary browser without an extension or API key.

1. Install Open for Agents: AI Toolkit with MCP. For the current beta, install the core plugin from the distributed package in your WordPress admin plugin upload screen. After WordPress.org approval, you will also be able to install directly from the repository. The optional Open for Agents Assistant is a separate package and does not include hosted model access.
2. Enable Standard Tools. Turn on the built-in, deterministic, read-only baseline. This immediately adds get_site_info, list_post_types, get_navigation, list_posts, search_posts, get_post, and get_terms. On WooCommerce sites it also adds woo_search_products, woo_get_product, and woo_get_product_categories.
3. Review the baseline catalog. Standard Tools appears in the same effective catalog that will later hold any discovered capabilities. Confirm the built-in read-only tools you want available before you scan anything.
4. Validate before publishing. Review each capability for type, risk, confidence, and auth requirements. You can validate Standard Tools without running a scan. Use the Action Types Reference to interpret labels and flags.
5. Choose a publication tier and publish. Select public_minimal, public_standard, or private_full based on your exposure policy, then enable publishing and run diagnostics. Until publishing is enabled, public endpoints return 404 by design. See Publication Tiers for tier-by-tier guidance.
6. Run an optional discovery scan later. Use Quick Scan or Full Scan when you want forms, AJAX routes, plugin-specific flows, selectors, and richer browser runtime bindings that are unique to your site.
7. Review integrations separately. For Contact Form 7 or WPForms Lite, confirm the provider detector, supported field schema, publication maturity, tested version, and limitations in the Integrations matrix. Certified form execution is limited to supported single-page forms, irreversible, disabled by default, and enabled per reviewed form—not for every form from a provider.

First Publish Runbook

1. From Setup, enable Standard Tools and confirm the baseline capabilities appear in Review.
2. If WooCommerce is active, confirm product search, product lookup, and product category tools were added automatically.
3. If an established form provider is active, confirm only the intended forms were detected. Keep transactional execution off until each form's fields, notifications, redirects, and feeds have been reviewed.
4. In Review, confirm the built-in capabilities you want in scope and disable anything you do not plan to publish.
5. In settings, choose your tier (usually public_standard for practical public utility, or public_minimal for discovery-only exposure).
6. Open Publish and review Tier Preview counts. Confirm high-risk or auth-required capabilities are not in your chosen public tier.
7. Run diagnostics while publishing is still off. Expected behavior: public endpoints return 404 by design.
8. Enable publishing and run diagnostics again. Expected behavior: endpoint checks report OK, and your public map is available via the public URL in Publish.
9. Run a Quick Scan or Full Scan later when you want deeper site-specific discovery, then validate the newly discovered items before republishing.

Release Readiness Contract

Setup, Review, Validate, and Publish describe one readiness state, not four independent checklists. Publishing can be active without being current, but it should not be presented as complete when the selected public catalog has changed, validation is stale or partial, or public diagnostics disagree with the configured state.

• A sampled validation run reports only the endpoints it exercised. It does not imply that every catalog tool passed.
• Catalog, tier, runtime, or host changes make the previous validation evidence stale until the affected checks run again.
• Treat publication as ready only when every selected public surface has current validation evidence and the public diagnostics agree.