=== MCP for WordPress by Kites.Dev ===
Contributors: jabedbhuiyan, jabedbd
Donate link: https://kites.dev
Tags: mcp, ai, claude, cursor, llm
Requires at least: 6.0
Tested up to: 7.1
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect WordPress as a Model Context Protocol (MCP) server to AI agents like Claude Desktop, Cursor, LangChain, and AutoGen securely.

== Description ==

MCP for WordPress by Kites.Dev turns your WordPress website into a fully compatible **Model Context Protocol (MCP)** server. Built by [Kites.Dev](https://kites.dev), this plugin allows you to seamlessly connect your WordPress site directly to your favorite AI assistants and environments—including **Claude Desktop**, **Cursor IDE**, **Windsurf**, **ChatGPT / Custom GPTs**, **LangChain**, **AutoGen**, and custom Python scripts.

= What You Can Do With This Plugin =

* ✍️ **Draft, Edit & Publish Content Directly**: Ask your AI agent to draft new blog posts, rewrite existing articles, create pages, assign categories and tags, and publish or save as draft directly from your AI chat window.
* 🖼️ **Manage Media Assets**: Upload images and featured graphics directly to your WordPress Media Library via your AI assistant.
* 🔍 **Query & Update WordPress Data**: Search posts, pages, custom post types, and retrieve published content contextually for AI-assisted writing or research.
* 🛠️ **Inspect Site Diagnostics & Schema**: Let your AI agent inspect active themes, plugin configurations, database table structures, and site health parameters for fast site troubleshooting.
* 🛡️ **Stay Safe with Read-Only Mode & Scope Guardrails**: Toggle global Read-Only mode or assign read-only scope to specific API keys to prevent AI models from executing destructive write operations.
* 📊 **Real-Time Audit Logging**: Monitor every single incoming AI request, tool invocation payload, response code, client IP address, and execution duration from your WordPress dashboard.

= Supported AI Tools & Clients =
* **Claude Desktop**: Native JSON-RPC 2.0 and Server-Sent Events (SSE) support via `claude_desktop_config.json`.
* **Cursor & Windsurf IDEs**: Interact with your live site while building themes or plugins.
* **OpenAI & Custom GPTs**: Connect custom actions via standard HTTP POST endpoints.
* **LangChain & AutoGen Frameworks**: Automate content pipelines and scheduled publishing programmatically.

= Key Features =
* **Full MCP Specification Support**: Support for JSON-RPC 2.0 transport over HTTP POST and SSE (Server-Sent Events).
* **Robust Security**: Hashed API keys (SHA-256), IP Whitelisting, and rate limiting per key/IP.
* **Granular Capability Enforcement**: All MCP tool executions validate native WordPress user capabilities (`edit_posts`, `publish_posts`, `manage_options`).
* **Read-Only Mode Option**: Enforce read-only access globally to prevent AI agents from making destructive modifications.
* **Detailed Audit Logging**: Inspect every AI tool invocation, payload, response code, IP address, and execution duration.
* **Modern WP Admin Interface**: Built-in key generator and live log viewer.

== Installation ==

1. Upload the `kites-ai-connector-for-model-context-protocol` directory to your `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to **WPMCP Settings** in your WordPress dashboard.
4. Generate a new API key under **API Keys**.
5. Configure your MCP Client (e.g. Claude Desktop `claude_desktop_config.json`) with your endpoint URL: `https://your-site.com/wp-json/wpmcp/v1/mcp` and your Bearer API Key.

== Screenshots ==

1. Settings & Security Configuration
2. API Key Management & Generator
3. Real-time Audit Logs Viewer

== Changelog ==

= 1.0.6 =
* Modern UI upgrade with iOS-style toggle switches, tool capability pill badges, and clean card rows.
* Seamless URL query parameter routing (?page=wpmcp-settings&tab=...).
* Full isolation for WordPress admin notices and instant audit log pagination with log clean-up option.

= 1.0.5 =
* Clean, minimal, lightweight UI redesign with refined typography and instant starter prompts.

= 1.0.4 =
* Complete redesign of admin interface into a unified modern dashboard with 1-click AI Agent configurations and master prompt generator.

= 1.0.3 =
* Expanded description section with detailed user guide for Claude, ChatGPT, Cursor, and AI agent integration.

= 1.0.2 =
* Resolved readme tags count, removed non-existent contributor username, and optimized short description length.

= 1.0.1 =
* Updated plugin display title for enhanced search visibility.

= 1.0.0 =
* Initial release of WPMCP. Full MCP protocol support with security guardrails and WP REST endpoint transports.
