=== AI-Ready WP ===
Contributors: studiomeyerio
Donate link: https://studiomeyer.io
Tags: ai, seo, chatgpt, llms-txt, schema
Requires at least: 6.9
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 4.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make your WordPress site discoverable by AI agents: agents.json, agent-card.json, llms.txt, JSON-LD schemas, and a full SEO module.

== Description ==

**AI-Ready WP** makes your WordPress site discoverable by AI agents and search engines. It generates the files and metadata that AI systems look for when trying to understand what your site offers.

As AI agents become the new way people find businesses online, your site needs to speak their language. AI-Ready WP handles this automatically.

= What It Does =

**AI Discovery**

* **agents.json** — AI Agent Discovery standard (/.well-known/agents.json). Tells AI systems what your site offers and how to interact with it.
* **agent-card.json** — A2A Protocol (Agent-to-Agent) for agent interoperability (/.well-known/agent-card.json).
* **mcp.json** — Optional MCP server discovery manifest (/.well-known/mcp.json). Off by default; point AI clients to the MCP servers you list in the settings.
* **llms.txt** — LLM-readable content index (/llms.txt + /llms-full.txt). Like a sitemap for AI.
* **JSON-LD schemas** — Organization/LocalBusiness, WebSite with SearchAction, BreadcrumbList, FAQPage.
* **REST API** — Endpoints for AI agents (/wp-json/airewp/v1/).
* **AI Bot Management** — Granular robots.txt control for 20+ AI bots. Block training bots, allow search bots.
* **AI Crawler Analytics** — Track which AI bots visit your site and how often.
* **IndexNow** — Instant indexing notifications to Bing and Yandex on content changes.
* **WP Abilities API** — Machine-readable abilities for the WordPress MCP Adapter (WP 6.9+).
* **AI-Readiness Score** — Dashboard widget with 12 readiness checks.
* **16 industry presets** — Restaurant, real estate, e-commerce, SaaS, agency, medical, legal, and more.
* **Auto-regeneration** — Files update automatically on content changes and daily via WP-Cron.

**SEO**

* Meta title and description per page/post (editor meta box).
* OpenGraph tags (og:title, og:description, og:image, og:type).
* Twitter Card tags (summary_large_image).
* Canonical URL override per page.
* Robots meta (noindex/nofollow) per page.
* XML Sitemap generation (/sitemap.xml).
* Focus keyword analysis with 6-point checklist (title, URL, meta, density, length, intro).

= Who Is This For? =

* **Business owners** who want their site found by ChatGPT, Claude, Perplexity, and other AI assistants.
* **Agencies** building client sites that need to be future-proof for AI discovery.
* **Developers** who want a lightweight, well-coded AI discovery solution.

= How It Works =

1. Install and activate the plugin.
2. Go to Settings > AI-Ready.
3. Fill in your business information.
4. Enable the features you need.
5. Everything generates and updates automatically.

Your site immediately becomes discoverable by AI agents through standardized protocols.

= More free plugins by StudioMeyer =

* [SmartBot](https://wordpress.org/plugins/smartbot-ai-chatbot/) — an AI chatbot that answers your visitors' questions 24/7.
* [Agent Discovery for WooCommerce](https://wordpress.org/plugins/studiomeyer-agent-discovery-for-woocommerce/) — expose UCP, A2A, and agents.json endpoints so AI shopping agents can find your products.

== Installation ==

= Quick start (about 2 minutes) =

1. In WordPress, go to **Plugins → Add New**, search for "AI-Ready WP", then click **Install Now** and **Activate**.
2. Open **Settings → AI-Ready** and fill in your business name, description, and contact details.
3. Choose your industry preset and save. That is it — agents.json, llms.txt, JSON-LD, and the SEO files generate automatically and keep themselves up to date.

Check the **AI-Readiness Score** widget on your Dashboard to see what is live and what to improve.

= Manual installation =

1. Download the plugin ZIP.
2. Go to **Plugins → Add New → Upload Plugin**, upload the ZIP, then click **Install Now** and **Activate**.

= SEO settings (optional) =

Edit any page or post and open the **SEO Settings** box below the editor to set a custom meta title, description, focus keyword, and canonical URL. OpenGraph and Twitter Cards are handled for you.

== Frequently Asked Questions ==

= What is agents.json? =

agents.json is an emerging standard for AI agent discovery. It tells AI systems what your website offers and how to interact with it — like a machine-readable menu of your site's capabilities.

= What is llms.txt? =

llms.txt is a structured text file that gives LLMs (Large Language Models) a concise overview of your website content — like a sitemap for AI.

= What is the A2A Protocol? =

A2A (Agent-to-Agent) is a protocol by Google (now under the Linux Foundation) for AI agent interoperability. The agent-card.json file lets agents discover and communicate with your site.

= Does this replace Yoast SEO? =

For most sites, yes. AI-Ready WP provides meta titles/descriptions, OpenGraph, Twitter Cards, canonical URLs, robots meta, XML Sitemaps, and focus keyword analysis. If you need advanced features like redirect managers or internal linking suggestions, you may want to keep a dedicated SEO plugin alongside.

= Does this work with existing SEO plugins? =

Yes. If you already use Yoast or Rank Math, AI-Ready WP's SEO module can be disabled. The AI Discovery features work alongside any SEO plugin.

= Does this work with WooCommerce? =

Yes. If WooCommerce is active, the plugin automatically adds product catalog tools to agents.json, making your products discoverable by AI agents.

= Why should I care about AI discovery? =

AI assistants like ChatGPT, Claude, and Perplexity are increasingly used to find businesses and services. If your site isn't AI-discoverable, you're invisible to this growing channel. AI-Ready WP makes your site speak the language AI agents understand.

= Does this make external connections? =

The only external connection is IndexNow (optional), which notifies search engines about content changes. All other features work entirely locally. See the Third-Party Services section below.

= Can I control which AI bots access my site? =

Yes. The AI Bot Management feature lets you block training bots (that scrape your content for model training) while allowing retrieval bots (that help users find your site through AI search).

== Screenshots ==

1. Settings page with the AI-Readiness Score and business information fields.
2. SEO Settings meta box in the block editor — title, description, focus keyword, canonical URL, noindex/nofollow.
3. Dashboard widget with AI-Readiness Score checklist — 12 checks at a glance.
4. Feature toggles and AI bot policy — switch on the discovery features you need and choose which AI bots may crawl your content.

== Third-Party Services ==

This plugin connects to the following external service:

= IndexNow API =

When IndexNow is enabled, the plugin notifies search engines about content changes for faster indexing:

* **Service URLs:**
  * `https://api.indexnow.org/indexnow`
  * `https://www.bing.com/indexnow`
* **Data sent:** Your site URL, the URLs of changed pages, and your IndexNow key
* **When:** On content publish or update
* **Purpose:** Faster search engine indexing by Bing, Yandex, and other participating search engines
* **IndexNow:** [https://www.indexnow.org](https://www.indexnow.org)
* **IndexNow Terms of Use:** [https://www.indexnow.org/terms](https://www.indexnow.org/terms)
* **IndexNow Privacy:** [https://www.indexnow.org/privacy](https://www.indexnow.org/privacy)
* **Bing IndexNow:** [https://www.bing.com/indexnow](https://www.bing.com/indexnow)
* **Microsoft Privacy Statement:** [https://privacy.microsoft.com/en-us/privacystatement](https://privacy.microsoft.com/en-us/privacystatement)

IndexNow is enabled by default but can be disabled in Settings > AI-Ready. No other external connections are made.

== Changelog ==

= 4.2.0 =
* Compatibility: Tested up to WordPress 7.0 (released May 2026).
* New: Each AI-Ready ability now declares `meta.show_in_rest` and a `readonly` annotation. WordPress 7.0 ships the Abilities API and AI Client in core, and these annotations let the MCP Adapter and AI Client know the abilities only read site data and never mutate it.
* Changed: Minimum required WordPress version is now 6.9 (previously 6.0). The Abilities API that powers the MCP Adapter integration ships with WordPress 6.9, and 6.9/7.0 are the versions this plugin is tested against. Sites on older WordPress simply keep version 4.1.1.
* Housekeeping: Uninstall cleanup now uses WordPress core APIs (`delete_post_meta_by_key()`) instead of direct SQL for post meta removal.
* New: Optional mcp.json endpoint (/.well-known/mcp.json) — publish an MCP server discovery manifest for the MCP servers you list in the settings. Off by default.
* New: Suggested privacy policy text under Settings → Privacy (the plugin stores no personal data — this documents exactly that).
* Fix: llms.txt no longer contains an empty description blockquote when no business description is set; company name and description now fall back to the site title and tagline.
* Fix: llms.txt only advertises discovery endpoints that are actually enabled (no more links to disabled endpoints).
* Fix: The "REST API" settings toggle now actually disables the /wp-json/airewp/v1/ endpoints when unchecked.
* Removed: The builtBy tool credit from the agent-card.json extensions block — your agent card is your document, not our ad.
* No breaking changes. The classic SEO meta box, REST API behavior, and the agents.json format are unchanged.

= 4.1.1 =
* Fix: Register WP Abilities on the `wp_abilities_api_init` action instead of `init`. Resolves a `_doing_it_wrong` notice on WordPress 6.9 ("Abilities must be registered on the wp_abilities_api_init action") and ensures the four `airewp/*` abilities are picked up by the WordPress MCP Adapter.
* Fix: Each ability now declares the required `category` property and uses the new `execute_callback` key (renamed from `callback` in WP 6.9). Without these the abilities were registered but discarded with a `_doing_it_wrong` notice.
* New: Plugin registers its own ability category `airewp` (label "AI-Ready WP") on `wp_abilities_api_categories_init` so all four abilities are grouped under one heading in the MCP Adapter and Abilities admin views.
* Tested with WordPress 6.9.4. No changes to features or settings — pure compatibility update.

= 4.1.0 =
* Focus: AI Discovery + SEO as a complete free package.
* All features are free — no license key required.
* Full SEO module: meta title/description, OpenGraph, Twitter Cards, canonical URL, robots meta, XML Sitemap, focus keyword analysis.
* Full AI Discovery: agents.json, agent-card.json, llms.txt, JSON-LD, REST API, AI Bot Management, Crawler Analytics, IndexNow, WP Abilities.
* AI-Readiness Score dashboard widget with 11 checks.
* 16 industry presets.
* Improved output escaping and security hardening.

= 3.0.0 =
* AI Bot Management — granular robots.txt control for 20+ AI bots.
* AI Crawler Analytics — track AI bot visits.
* WP Abilities API — registers abilities for WordPress MCP Adapter (WP 6.9+).
* A2A v0.3 agent.json — canonical A2A path with backward-compatible agent-card.json.

= 2.0.0 =
* REST API endpoints, BreadcrumbList/FAQPage schemas.
* IndexNow integration for instant search engine indexing.

= 1.0.0 =
* Initial release with agents.json, agent-card.json, llms.txt, JSON-LD, Dashboard widget, 16 presets.

== Upgrade Notice ==

= 4.2.0 =
Tested up to WordPress 7.0. Abilities now declare read-only annotations and REST visibility for the new core AI Client and MCP Adapter. Requires WordPress 6.9+.

= 4.1.1 =
WordPress 6.9 compatibility: Abilities now register on `wp_abilities_api_init` with the required `category` and `execute_callback` properties.

= 4.1.0 =
All features are now free. Full SEO module and AI Discovery in one lightweight package.

= 3.0.0 =
AI Bot Management, Crawler Analytics, WP Abilities API, A2A v0.3.

= 1.0.0 =
First release.
