Description
Conversion Agent Discovery helps WordPress sites expose public, read-only discovery surfaces for AI agents without pretending to support capabilities that are not implemented.
It is designed to improve measurable agent accessibility for public, read-only discovery checks without calling external scanners automatically.
Features include:
- Markdown negotiation for public content with
Accept: text/markdown. - Content Signals in
robots.txt. - Generated
llms.txtand/.well-known/llms.txt. - Generated
/.well-known/api-catalog. - Generated
/.well-known/agent-skills/index.jsonand virtualSKILL.mdfiles. - Local Agent Skills discovery schema generated by the site.
- Read-only WebMCP tool registration for compatible browsers.
- Public read-only REST endpoints for site search, recent content, single content reads, site context, and contact handoff.
- Admin settings page with a global kill switch.
Conversion Agent Discovery does not publish fake OAuth, MCP Server Card, A2A, or commerce metadata.
External Services
This plugin does not send requests to external services automatically and does not transmit visitor or site data to third parties.
The generated Agent Skills discovery document uses a local schema URL served by the WordPress site at /.well-known/agent-skills/discovery-0.2.schema.json; it does not depend on an external schema service.
The plugin contains optional external links that administrators or users may open manually:
https://conversion.ag/is linked for Conversion attribution and plugin author information. The plugin does not send visitor or site data to Conversion; the link is opened only when a user clicks it manually. Conversion’s privacy policy is available at https://www.conversion.com.br/politica-de-privacidade/.https://github.com/agencia-conversion/conversion-agent-discoveryis linked as the public development repository and release source. The plugin does not send visitor or site data to GitHub; the link is opened only when a user clicks it manually. GitHub’s terms are available at https://docs.github.com/en/site-policy/github-terms/github-terms-of-service and GitHub’s privacy statement is available at https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement.https://wordpress.org/plugins/wp-graphql/is linked from the admin screen when WPGraphQL is not detected, so administrators can optionally install it. The plugin does not send visitor or site data to WordPress.org; the link is opened only when an administrator clicks it manually. WordPress.org’s privacy policy is available at https://wordpress.org/about/privacy/ and terms are available at https://wordpress.org/about/terms-of-service/.
Conversion’s privacy policy is available at https://www.conversion.com.br/politica-de-privacidade/.
Privacy
Conversion Agent Discovery does not track users and does not send site data to external services automatically. Outbound links in the admin screen and readme are plain manual links.
Development
Development happens at https://github.com/agencia-conversion/conversion-agent-discovery. The distributed plugin contains readable PHP, JavaScript, CSS, and SVG source files; no build step is required to run the plugin.
Installation
- Upload the plugin ZIP in Plugins > Add New > Upload Plugin.
- Activate Conversion Agent Discovery.
- Open Settings > Conversion Agent Discovery.
- Review metadata and enabled modules.
- Purge site cache after activation.
FAQ
-
Does this change the HTML site?
-
No. Normal browser and crawler requests continue to receive HTML. Markdown is returned only when the request explicitly sends
Accept: text/markdown. -
Does this create an MCP server?
-
No. Conversion Agent Discovery publishes only real read-only resources. It does not publish an MCP Server Card unless a real MCP server exists.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Conversion Agent Discovery” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Conversion Agent Discovery” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.10
- Add bundled translations for 10 WordPress locales: Brazilian Portuguese, European Portuguese, Spanish, French, German, Italian, Dutch, Russian, Japanese, and Simplified Chinese.
- Add a generated POT catalog and load bundled translation files from
/languages. - Move WebMCP tool descriptions into translatable PHP configuration while keeping tool names and endpoints stable.
0.1.9
- Serve the Agent Skills discovery schema locally from the WordPress site.
- Remove non-essential external measurement links from the WordPress.org package.
- Clarify the External Services documentation for manual links only.
0.1.8
- Rename the plugin package to Conversion Agent Discovery with slug and text domain
conversion-agent-discovery. - Move admin CSS, admin notices JavaScript, and WebMCP JavaScript to local enqueued assets.
- Replace legacy WP Agentic identifiers with Conversion Agent Discovery prefixes.
- Use
rest_url()for REST API discovery URLs. - Add WordPress.org external services documentation.
0.1.6
- Prepare WordPress.org submission metadata, privacy notes, development source link, and package exclusions.
0.1.5
- Schedule rewrite flushes after plugin upgrades so third-party sitemap rules remain registered.
0.1.4
- Keep third-party WordPress admin notices out of the custom dashboard hero.
- Document measurement support for Is It Agent Ready and Agent Crawl by Conversion.
0.1.3
- Rename the public plugin name and distribution slug to Conversion Agent Discovery for WordPress.org directory compatibility.
- Add Conversion branding assets to the admin header and footer.
- Update plugin credit links to conversion.ag.
- Keep existing settings keys for smoother upgrades from earlier builds.
0.1.2
- Redesign the admin settings page as a richer dashboard with module explanations, scanner impact, diagnostics, and version footer.
- Add WPGraphQL status detection and installation guidance when WPGraphQL is not detected.
- Document why WebMCP is different from an MCP Server Card and keep fake OAuth, MCP Server Card, A2A, and commerce metadata unpublished.
0.1.1
- Add read-only WebMCP tools.
- Add public read-only Conversion Agent Discovery REST endpoints.
- Update Agent Skills discovery to v0.2 with virtual SKILL.md artifacts and SHA-256 digests.
- Add Markdown frontmatter and Content-Signal response headers.
- Add explicit Link headers for agent resources.
0.1.0
- Initial release.
