Conversion Agent Discovery

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.txt and /.well-known/llms.txt.
  • Generated /.well-known/api-catalog.
  • Generated /.well-known/agent-skills/index.json and virtual SKILL.md files.
  • 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-discovery is 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

  1. Upload the plugin ZIP in Plugins > Add New > Upload Plugin.
  2. Activate Conversion Agent Discovery.
  3. Open Settings > Conversion Agent Discovery.
  4. Review metadata and enabled modules.
  5. 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.

Contributors

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.