=== MCP Tracker ===
Contributors: wpvibes, gajendrasingh
Tags: mcp, rest-api, logging, developer-tools, debugging
Requires at least: 6.9
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 0.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Records and displays MCP-related REST API requests made to your WordPress site.

== Description ==

MCP Tracker is an admin-only WordPress plugin that helps administrators monitor and understand MCP (Model Context Protocol) related REST API requests made to their WordPress site.

= Features =

* **Automatic Detection**: Automatically detects MCP requests by identifying the `Mcp-Session-Id` header
* **Comprehensive Logging**: Records request details including route, method, headers, and response data
* **User Tracking**: Shows which WordPress user triggered each request (or identifies guest requests)
* **Advanced Filtering**: Filter requests by date range, tool name, and user
* **Detailed View**: View complete request headers and response bodies in formatted JSON
* **Privacy Focused**: All data stays on your server - no external transmission
* **Performance Optimized**: Minimal impact on site performance with efficient database queries

= Use Cases =

* Monitor MCP tool usage on your WordPress site
* Debug MCP integration issues
* Understand which tools are being called and when
* Track API response patterns
* Audit MCP-related activity

= Technical Details =

* Uses WordPress REST API hooks for non-intrusive logging
* Custom database table with proper indexing
* Secure admin-only access with capability checks
* Nonce verification for all admin actions
* Prepared SQL statements for security
* Self-healing database table creation

== Installation ==

1. Upload the `mcp-tracker` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to 'MCP Tracker' in the WordPress admin menu
4. Start monitoring MCP requests!

== Frequently Asked Questions ==

= What is MCP? =

MCP (Model Context Protocol) is a protocol for communication between AI models and external tools or services. This plugin helps you monitor MCP-related requests to your WordPress site.

= Does this plugin modify REST requests? =

No. MCP Tracker only logs requests for monitoring purposes. It does not modify, block, or alter any REST API requests or responses.

= Where is the data stored? =

All logged data is stored in a custom database table in your WordPress database. No data is sent to external services.

= Will this slow down my site? =

No. The plugin uses efficient WordPress hooks and database queries with minimal performance impact. Logging only occurs for MCP requests (identified by the `Mcp-Session-Id` header).

= Can I delete old logs? =

Currently, logs are stored indefinitely. You can manually clear the database table if needed. Future versions may include automatic cleanup options.

= Who can access the MCP Tracker interface? =

Only users with the `manage_options` capability (typically administrators) can access the MCP Tracker admin interface.


== Changelog ==

= 1.0.0 =
* Initial release
* MCP request detection and logging
* Filtering by date, tool, and user
* Detailed request viewer

== Upgrade Notice ==

= 1.0.0 =
Initial release of MCP Tracker.