Kiera Howe

<p>WebSamurai brings AI capabilities to your WordPress site through a powerful Model Context Protocol (MCP) server implementation. This plugin provides a secure interface for your AI tools to interact with your WordPress installation.</p>
<p>The premium service will allow you to simply type your command on the front-end and it will update your pages or posts or other types based on your prompt.</p>
<h4>Key Features</h4>
<ul>
<li><strong>Model Context Protocol (MCP) Server</strong> – HTTP-based MCP server with JSON-RPC 2.0 implementation</li>
<li><strong>Secure API Key Authentication</strong> – Generate and manage API keys with enterprise-grade security</li>
<li><strong>Easy-to-Use Admin Interface</strong> – React-based admin panel for managing API keys</li>
<li><strong>OAuth Integration</strong> – Built-in OAuth support for secure authentication to the remote services</li>
<li><strong>Developer-Friendly</strong> – Clean, extensible codebase following WordPress coding standards</li>
</ul>
<h4>Use Cases</h4>
<ul>
<li>Connect Claude Desktop, Claude Code, ChatGPT or your favorite AI Assistant to your WordPress site</li>
<li>AI-powered content management</li>
<li>Create custom AI tools that interact with WordPress</li>
<li>Automate WordPress tasks using AI</li>
<li>Run instructions directly from your site</li>
<li>Allow your clients an easy interface to AI driven content</li>
</ul>
<h4>Technical Highlights</h4>
<ul>
<li>JSON-RPC 2.0 over HTTP protocol</li>
<li>Stateless HTTP transport (no persistent connections required)</li>
<li>API key-based authentication (X-API-Key or Authorization Bearer)</li>
<li>Keys prefixed with <code>sk_</code> followed by 64 hexadecimal characters</li>
<li>Standard JSON-RPC error handling</li>
</ul>
<h4>Getting Started</h4>
<ol>
<li>Install and activate the plugin</li>
<li>Navigate to WebSamurai in your WordPress admin menu</li>
<li>Generate an API key with a descriptive name</li>
<li>Copy your API key immediately (you won’t be able to see it again)</li>
<li>Use the API key to connect your AI tools to WordPress</li>
</ol>
<h3>Premium Service</h3>
<ol>
<li>Sign up for an account on WebSamurai.</li>
<li>On your admin panel, Navigate to WebSamurai, OAuth Connection</li>
<li>Connect to the server</li>
<li>You will now see an “AI” tab on the front of your website that will allow you to make prompts to the AI.</li>
<li>The will also be a “Generate Image” on the Media and on the Image block that will allow you to create images.</li>
</ol>
<h4>API Endpoints</h4>
<ul>
<li>Main MCP Endpoint: <code>/wp-json/websamurai/v1/mcp</code></li>
<li>Server Info: <code>/wp-json/websamurai/v1/mcp/info</code></li>
<li>API Key Management: <code>/wp-json/websamurai/v1/api-keys</code></li>
</ul>
<h4>Claude Desktop Configuration</h4>
<p>Take a look at https://www.websamurai.io/chatbot_setup/ to see how to setup various chatbots</p>
<h4>Developer Resources</h4>
<ul>
<li>Built with React and WordPress REST API</li>
<li>Follows WordPress coding standards</li>
<li>Extensible architecture for adding custom tools</li>
<li>Comprehensive MCP server implementation</li>
</ul>
<h4>Automatic Installation</h4>
<ol>
<li>Log in to your WordPress admin panel</li>
<li>Navigate to Plugins > Add New</li>
<li>Search for “WebSamurai”</li>
<li>Click “Install Now” and then “Activate”</li>
</ol>
<h4>Manual Installation</h4>
<ol>
<li>Download the plugin ZIP file</li>
<li>Log in to your WordPress admin panel</li>
<li>Navigate to Plugins > Add New > Upload Plugin</li>
<li>Choose the ZIP file and click “Install Now”</li>
<li>Click “Activate Plugin”</li>
</ol>
<h4>Post-Installation Setup</h4>
<ol>
<li>Navigate to WebSamurai in the admin menu</li>
<li>Generate your first API key</li>
<li>Copy the API key and store it securely</li>
<li>Configure your AI tools to use the API key</li>
</ol>
<h3>Privacy Policy</h3>
<p>WebSamurai stores API keys in your WordPress database. No data is sent to external servers unless you configure external AI tools to connect to your site.</p>
<h3>Support</h3>
<p>For support, documentation, and updates, please visit:<br />
* Website: https://websamurai.io<br />
* Documentation: Included in plugin (MCP-SERVER.md)</p>
<h3>Credits</h3>
<p>WebSamurai is developed and maintained by the WebSamurai team.</p>
<p>Built with:<br />
* React<br />
* WordPress REST API<br />
* Model Context Protocol<br />
* Babel & Webpack</p>


WebSamurai

AI-powered features for WordPress with Model Context Protocol (MCP) server support and Advanced Chat

Riaan K.

<p>AI agents are starting to talk to WordPress sites directly. Claude Desktop, ChatGPT custom GPTs, and a growing list of MCP clients can connect to your site, browse content, place orders, edit posts, or call any custom tool you expose. The Model Context Protocol (MCP) is the open standard that makes this possible.</p>
<p>The problem: by default, you can’t see any of it. Requests come in, things change, and there’s no record of what an agent actually did, when it did it, or which user it acted as.</p>
<p>Activity Log for MCP records every MCP request the moment it hits your site. You see the route, the ability that was called, the user it acted as, the request body, the response, and whether it succeeded. Everything is browsable in a clean React admin page that feels like the rest of WordPress.</p>
<p>If you’re running an AI integration, debugging a custom MCP server, or just want a paper trail before letting agents touch your data — this is the visibility layer.</p>
<h4>What you get</h4>
<p>A real-time log of every MCP request, with filters for date range, ability name, and user. Click any row to inspect the full request and response, copy bodies to your clipboard, or trace a single agent session end-to-end. Sortable columns, configurable per-page counts (10 to 500), and full-text search across request and response bodies. Export to CSV when you need to share findings or feed them into another tool.</p>
<p>The whole interface is built with <code>@wordpress/components</code> so it inherits the WordPress design language — no jarring custom UI to learn.</p>
<h4>Built for both halves of the audience</h4>
<p>If you’re a site owner: install, activate, and click into Tools <span aria-hidden="true" class="wp-exclude-emoji">→</span> MCP Logs. There’s no setup screen and no configuration — the plugin starts logging the moment an MCP client makes a request.</p>
<p>If you’re a developer: there’s a full REST API for every admin feature, authenticated via WordPress Application Passwords or WooCommerce API keys. The plugin is also itself MCP-aware — it registers an MCP server with seven abilities, so an AI agent can introspect its own activity log programmatically. Source ships under <code>src/</code> and builds with <code>npm run build</code>.</p>
<h4>Why you’d want this</h4>
<ul>
<li>Debug a custom MCP integration without tailing server logs</li>
<li>Audit AI agent activity on production sites before something goes wrong</li>
<li>Review per-tool error rates to spot which abilities are flaky</li>
<li>Trace a single agent session end-to-end when something breaks</li>
<li>Export logs for compliance reviews or external analysis</li>
<li>Let an AI agent monitor its own activity through the MCP server</li>
</ul>
<h4>REST API</h4>
<p>Every admin feature is exposed under <code>/wp-json/activity-log-for-mcp/v1/</code>:</p>
<ul>
<li><code>GET /requests</code> — list with filters, sort, and pagination</li>
<li><code>GET /stats</code> — totals, success rate, and calls per ability</li>
<li><code>GET /sessions/{id}</code> — every request in a session, in order</li>
<li><code>GET /search</code> — full-text across routes, abilities, and bodies</li>
<li><code>GET /errors</code> — recent failed executions and HTTP errors</li>
<li><code>GET /tool-performance</code> — per-ability call count, error rate, and unique users</li>
<li><code>GET /filters</code> — distinct ability names and users for dropdowns</li>
<li><code>GET /export-csv</code> — server-side streamed CSV download</li>
<li><code>DELETE /requests</code> — clear all logs</li>
<li><code>DELETE /retention</code> — delete logs older than a given date</li>
</ul>
<h4>MCP abilities</h4>
<p>The plugin registers itself as an MCP server (<code>activity-log-for-mcp-server</code>) with seven abilities agents can call directly:</p>
<ul>
<li><code>get-activity</code> — paginated log retrieval with filters</li>
<li><code>get-stats</code> — summary metrics with optional date range</li>
<li><code>get-activity-by-session</code> — full session trace, with optional body exclusion for lighter payloads</li>
<li><code>search-activity</code> — full-text search across stored requests and responses</li>
<li><code>analyze-errors</code> — recent errors with full details</li>
<li><code>get-tool-performance</code> — per-ability performance metrics</li>
<li><code>clear-old-logs</code> — date-based retention cleanup</li>
</ul>
<h4>Privacy and data handling</h4>
<p>All data stays in your WordPress database — nothing is sent anywhere. Logs live in a custom table named <code>{prefix}alfmcp_requests</code>. You control retention and can clear everything from the admin UI or via REST. There’s no telemetry, no third-party calls, no external dependencies at runtime.</p>
<h4>Disclaimer</h4>
<p>Activity Log for MCP is not affiliated with, endorsed by, or sponsored any AI provider or the Model Context Protocol project. “MCP” and “Model Context Protocol” are referenced solely to describe the open protocol that this plugin observes.</p>
<h3>Privacy Policy</h3>
<p>Activity Log for MCP records REST API requests that contain the <code>Mcp-Session-Id</code> header. Logged data includes request routes, methods, headers, bodies, response data, user IDs, and timestamps. All data is stored in your WordPress database and is never transmitted to external services.</p>


Activity Log for MCP

See exactly what AI agents do on your WordPress site. A complete activity log for every Model Context Protocol (MCP) request.

WebSamurai vs Activity Log for MCP