WP Agent Ready

WordPress plugin that exposes published content to AI agents and LLMs via a clean, structured REST API.

What it does

• REST endpoint /wp-json/wpar/v1/content returning clean, HTML-stripped content
• Optional Yoast SEO integration (meta description, SEO title)
• Basic rate limiting (60 req/hour per IP) via transients
• Webhook receiver for re-indexing from an external MCP server
• Exposes /.well-known/mcp.json for MCP discoverability (includes MCP server URL when configured)
• Generates /llms.txt at the site root when no other plugin already provides one (cooperative: does not override physical files written by Yoast SEO, Rank Math, etc.)
• Automatic updates from GitHub Releases — no manual ZIP upload required

What it does NOT do

• Generate AI content
• Modify existing content
• Depend on external APIs

Requirements

• WordPress 6.0+
• PHP 8.1+

Installation

1. Upload the wp-agent-ready/ folder to /wp-content/plugins/
2. Activate the plugin from the WordPress admin
3. The REST endpoint is immediately available at /wp-json/wpar/v1/content

Project structure

wp-agent-ready/
├── wp-agent-ready.php   ← plugin header + bootstrap
├── includes/
│   ├── endpoint.php     ← REST route registration
│   ├── handler.php      ← main request handler
│   ├── sanitizer.php    ← HTML cleaning
│   ├── yoast.php        ← optional Yoast SEO integration
│   ├── rate-limit.php   ← IP-based rate limiting
│   ├── webhook.php      ← webhook emitter/receiver
│   ├── updater.php      ← auto-updates from GitHub Releases
│   └── lib/              ← vendorized third-party libraries (plugin-update-checker)
├── public/
│   └── well-known.php   ← /.well-known/mcp.json + llms.txt
└── languages/           ← i18n ready

Development

composer install
composer run lint       # PHPCS
composer run analyse    # PHPStan
composer run check      # both

License

GPL-2.0-or-later — see LICENSE