buglens

# BugLens — WordPress MCP Server for Shared Hosting

![WordPress Plugin Version](https://img.shields.io/badge/version-3.1.0-blue)
![WordPress Tested](https://img.shields.io/badge/WordPress-6.9%2B-green)
![PHP Version](https://img.shields.io/badge/PHP-8.0%2B-purple)
![License](https://img.shields.io/badge/license-GPL%20v2%2B-orange)

**The only WordPress MCP server that works without SSH, root access, or Docker.** Connect Claude Code, Cursor, Codex, Cursor CLI, or any MCP-compatible AI agent to your WordPress site — even on shared hosting. Just a WordPress plugin and one command.

BugLens is a WordPress MCP server and AI agent development bridge that gives your AI coding tools full filesystem access over HTTPS. Read files, write code, search across themes and plugins, diff changes, and run WP-CLI commands — all through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). It also includes a visual bug reporter that captures CSS selectors, computed styles, screenshots, and console errors — structured data optimized for AI agents to understand and fix issues in one shot.

**WordPress development with AI agents on shared hosting — solved.**

```bash
# Connect Claude Code to your WordPress site in 30 seconds:
BUGLENS_URL=https://yoursite.com BUGLENS_KEY=your_key \
  Claude MCP add buglens -- npx -y buglens-mcp
```

---

## The Problem

AI coding agents like Claude Code, Cursor, and Codex are incredible — but they need **filesystem access** to be useful. On a VPS or local machine, that's easy. On **shared hosting** (where most WordPress sites live), you're stuck: no SSH, no CLI, no way to let your AI read or edit files.

**BugLens solves this.** Install the plugin, enable the Bridge API, and your AI agent has full development access over HTTPS.

---

## How It Works

```
┌──────────────────┐         HTTPS          ┌──────────────────────┐
│  Your Computer   │ ◄──────────────────── │  Any Hosting          │
│                  │                         │  (sh