Title: Conversion Agent Discovery
Author: agenciaconversion
Published: <strong>20 May 2026</strong>
Last modified: 7 June 2026

---

Search plugins

![](https://ps.w.org/conversion-agent-discovery/assets/banner-772x250.png?rev=3539174)

![](https://ps.w.org/conversion-agent-discovery/assets/icon-256x256.png?rev=3539045)

# Conversion Agent Discovery

 By [agenciaconversion](https://profiles.wordpress.org/agenciaconversion/)

[Download](https://downloads.wordpress.org/plugin/conversion-agent-discovery.0.3.0.zip)

 * [Details](https://en-gb.wordpress.org/plugins/conversion-agent-discovery/#description)
 * [Reviews](https://en-gb.wordpress.org/plugins/conversion-agent-discovery/#reviews)
 *  [Installation](https://en-gb.wordpress.org/plugins/conversion-agent-discovery/#installation)
 * [Development](https://en-gb.wordpress.org/plugins/conversion-agent-discovery/#developers)

 [Support](https://wordpress.org/support/plugin/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`.
 * Editable AI Instructions page for official brand facts and LLM guidance, starting
   empty with English templates by default.
 * Runtime Front-end Placement for exact, design-safe AI Instructions link placement
   across matching public header, footer, or page content components.
 * `[conversion_ai_instructions_link]` shortcode for manual placement.
 * 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.

The AI Instructions feature was inspired by Chris Long’s public LinkedIn post and
Nectiv case study showing that AI Instructions pages can be cited by ChatGPT in 
branded queries. It also credits the earlier Seer Interactive AI Information page
by Wil Reynolds and Alisa Scharf that Chris Long identified as an important example.

References:

 * Chris Long’s LinkedIn post: https://www.linkedin.com/posts/chris-long-marketing_holy-
   moly-seos-ai-instruction-pages-influence-share-7466096236799053824-_rpb/
 * Nectiv case study: https://nectivdigital.com/blog/aeo-experiment-chatgpt-cited-
   an-ai-instructions-page-in-48-hours
 * Nectiv AI Instructions example: https://nectivdigital.com/ai-instructions
 * Seer Interactive AI Information example: https://www.seerinteractive.com/ai-information
 * Omniscient Digital AI Info example: https://beomniscient.com/ai-info/
 * llms.txt proposal by Jeremy Howard: https://llmstxt.org/

Important: this plugin does not guarantee LLM citations, search rankings, AI Overview
visibility, or model behavior. It provides controlled public discovery surfaces 
for experimentation.

### 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.

### Does the AI Instructions feature change the front-end automatically?

Only when Front-end Placement is enabled and the configured snippet is found in 
rendered frontend HTML. The plugin does not edit saved page content, theme files,
or templates.

### Does this guarantee ChatGPT, Claude, Gemini, Perplexity, or Google AI citations?

No. Results may vary by model, search index, prompt, location, account context, 
retrieval behavior, and crawl timing.

## Reviews

There are no reviews for this plugin.

## Contributors and Developers

“Conversion Agent Discovery” is open source software. The following people have 
contributed to this plugin.

Contributors

 *   [ agenciaconversion ](https://profiles.wordpress.org/agenciaconversion/)

[Translate “Conversion Agent Discovery” into your language.](https://translate.wordpress.org/projects/wp-plugins/conversion-agent-discovery)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/conversion-agent-discovery/),
check out the [SVN repository](https://plugins.svn.wordpress.org/conversion-agent-discovery/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/conversion-agent-discovery/)
by [RSS](https://plugins.trac.wordpress.org/log/conversion-agent-discovery/?limit=100&mode=stop_on_copy&format=rss).

## Change Log

#### 0.3.0

 * Reorganize the admin screen into Overview, AI Instructions, Discovery Surfaces,
   and Diagnostics tabs.
 * Start AI Instructions empty and unpublished by default, with a generic English
   recommended structure and copyable English LLM prompt.
 * Replace Footer Replacement with visual Front-end Placement for header, footer,
   or page content snippets while keeping legacy settings compatible.
 * Add same-origin visual component selection, rich HTML editing, AI Instructions
   link insertion, and one-click placement publishing.
 * Force Front-end Placement to use the homepage as the visual editing source, apply
   matching replacements across public pages, and normalize the legacy `{link_test}`
   placeholder typo.
 * Stop advertising AI Instructions in llms.txt, Link headers, API Catalog, and 
   Agent Skills until content is published.

#### 0.2.1

 * Replace the direct `wp_footer` append behavior with configurable runtime Footer
   Replacement.
 * Add source page import preview, exact snippet selection, custom replacement template,
   and configurable link text.
 * Keep the default visual output restrained by linking only the `AI Instructions`
   text.

#### 0.2.0

 * Add editable AI Instructions page with accented Portuguese default content for
   conversion.com.br.
 * Add optional footer link and `[conversion_ai_instructions_link]` shortcode.
 * Add AI Instructions discovery links to `llms.txt`, Link headers, API Catalog,
   diagnostics, and Agent Skills.

#### 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.

## Meta

 *  Version **0.3.0**
 *  Last updated **3 hours ago**
 *  Active installations **20+**
 *  WordPress version ** 5.9 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/conversion-agent-discovery/)
 * Tags
 * [Agents](https://en-gb.wordpress.org/plugins/tags/agents/)[AI](https://en-gb.wordpress.org/plugins/tags/ai/)
   [discovery](https://en-gb.wordpress.org/plugins/tags/discovery/)[llms.txt](https://en-gb.wordpress.org/plugins/tags/llms-txt/)
   [markdown](https://en-gb.wordpress.org/plugins/tags/markdown/)
 *  [Advanced View](https://en-gb.wordpress.org/plugins/conversion-agent-discovery/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/conversion-agent-discovery/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/conversion-agent-discovery/reviews/)

## Contributors

 *   [ agenciaconversion ](https://profiles.wordpress.org/agenciaconversion/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/conversion-agent-discovery/)