PressBridge
Provides read-only access to a WordPress site's files and WP-CLI functionality: listing, reading and searching theme and plugin files, retrieving site overview (WordPress version, pending plugin/theme/core updates), running read-only WP-CLI commands such as plugin and theme lists, checksums, cron and user listings, and generating a client-ready health and security report. Sensitive files like wp-config.php, .env, SQL dumps, keys and .git are blocked, and access is confined to the site root.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PressBridge Where in the theme is the footer phone number set?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PressBridge Free
The WordPress MCP that still works when WordPress doesn't. Let Claude look inside your WordPress site safely: read-only, sandboxed, secrets hidden. Runs outside WordPress, so it works even when the site shows a critical error.
Website · Demo video · Get Pro · User guide · Security
you On mysite, where is the footer phone number set? And show me the DB password.
claude search "0744" in wp-content/themes → footer.php:41
read_file wp-config.php → refused: blocked by deny rule 'wp-config*'
The number is in wp-content/themes/mysite/footer.php, line 41.
I can't read wp-config.php: PressBridge hides it so passwords never reach me.PressBridge is an MCP server that gives Claude (Claude Code, Claude Desktop, any MCP client) controlled access to a WordPress site. The Free edition is read-only and made for one site: perfect for debugging, audits and "where is this text coming from?".
Read, list and search theme and plugin files
wp-config.php,.env, SQL dumps, keys and.gitare invisibleNothing outside the site folder, symlink tricks included
Read-only WP-CLI: versions, plugin and theme lists, checksums, cron, users
WooCommerce, read-only: products, stock, prices, coupons, shipping and taxes (set
wc_userin the config; orders and customers only if you turn them on)site_overview: version and pending updates in one callcheck_site_health: is the site up right now? Loads key pages and boots WordPressIncludes the wp-care-report and wp-white-screen skills, also as a Claude Code plugin
Install (5 minutes, nothing exposed to the internet)
On the server:
sudo apt install python3-venv php-cli php-mysql
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
sudo install wp-cli.phar /usr/local/bin/wp
python3 -m venv ~/pressbridge-venv
~/pressbridge-venv/bin/pip install pressbridge
mkdir -p ~/.pressbridge
cat > ~/.pressbridge/config.yaml <<EOF
data_dir: $HOME/.pressbridge/data
sites:
mysite:
root: /var/www/mysite/public_html
EOF
~/pressbridge-venv/bin/pressbridge check --config ~/.pressbridge/config.yamlRun it as the user that owns the site files (or one that can read them).
On your computer, Claude Code:
claude mcp add pressbridge -- ssh you@server \
/home/you/pressbridge-venv/bin/pressbridge serve --config /home/you/.pressbridge/config.yamlClaude Desktop (claude_desktop_config.json, Settings → Developer → Edit Config):
{
"mcpServers": {
"pressbridge": {
"command": "ssh",
"args": ["-o", "BatchMode=yes", "you@server",
"/home/you/pressbridge-venv/bin/pressbridge", "serve",
"--config", "/home/you/.pressbridge/config.yaml"]
}
}
}Claude Code plugin: skills and setup help
PressBridge is also a Claude Code plugin with the wp-white-screen skill (finds why a
site shows "There has been a critical error" and gives the exact fix), the
wp-care-report skill and a /pressbridge-setup command that walks you through the
install:
/plugin marketplace add pressbridgesupport/pressbridge
/plugin install pressbridge@pressbridgeThe plugin adds the skills; the MCP server itself still runs where the site files are,
as above. With uv you can skip the virtualenv and run
uvx pressbridge serve --config ~/.pressbridge/config.yaml.
Then ask Claude: "Give me a health overview of mysite" or "Where in the theme is the footer phone number set?"
The full user guide, with every command, config option and tool, is in GUIDE.md (features marked Pro aren't in this edition).
Related MCP server: mcp-wordpress
Want Claude to fix things too?
PressBridge Pro adds editing with automatic backups and one-call undo, a check after every change that rolls it back automatically if it broke the site, PHP syntax checks before saving, plugin/theme/core updates, unlimited sites, a remote HTTPS server with Docker and automatic certificates, the audit log, and skills for safe edits and safe updates.
→ https://pressbridgesupport.github.io/pressbridge
License
MIT. See LICENSE.
Available Tools
9 toolscheck_site_healthBRead-only
Load the site's key pages and boot WordPress now: is the site up, any fatal errors?
Inputs: site.
list_dirARead-only
List a folder inside a site. depth 1-4. Blocked files are hidden.
Inputs: path, site, depth.
list_sitesARead-only
List the WordPress sites you can work on, with what each one allows.
Inputs: no named parameters.
read_fileBRead-only
Read a text file. offset is the first line (1-based), limit the number of lines.
Inputs: path (required), site, limit, offset.
searchBRead-only
Regex search across files (like grep). glob filters file names, e.g. '*.php'.
Inputs: pattern (required), glob, path, site, +2 more.
site_overviewBRead-only
One-call health snapshot: WordPress version, pending updates, plugins and themes.
Inputs: site.
statBRead-only
Size, permissions and modified time of a file or folder.
Inputs: path (required), site.
wpC
Run an allowed WP-CLI command. args without 'wp', e.g. ["plugin", "list", "--update=available"].
Inputs: args (required), site.
wp_commandsCRead-only
Show which WP-CLI commands this site allows.
Inputs: site.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools are clearly separable by resource and action: file operations (list_dir, read_file, search, stat), site discovery (list_sites, wp_commands), and execution (wp). The only mild overlap is site_overview versus check_site_health, both framed as 'health' checks, though one is a data snapshot and the other a live boot probe.
Conventions are mixed: verb_noun (list_sites, list_dir, read_file, check_site_health), bare verbs/abbreviations (search, stat, wp), and noun phrases (wp_commands, site_overview). The wp/wp_commands pairing is internally coherent, but the set overall does not follow one predictable pattern.
Nine tools is well within the sweet spot for a WordPress inspection bridge. Each tool covers a distinct capability layer (site enumeration, filesystem, WP-CLI, health) without filler.
Read/inspect coverage is solid and wp provides a broad escape hatch for deeper WordPress operations. However, the filesystem surface is read-only (list_dir, read_file, search, stat) with no write/edit/delete counterpart, which is a notable gap if agents are expected to modify files.
Maintenance
Related MCP Connectors
Manage a WordPress site from your AI assistant: read, search, propose edits, Search Console data.
Manage your WordPress site from ChatGPT or Claude: posts, WooCommerce, SEO, images and upkeep.
Live-checks whether a WordPress site is ready to be safely operated by AI agents.
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Related MCP Servers
- AlicenseBqualityDmaintenanceConnects Claude to WordPress sites through the REST API, enabling AI-assisted content creation, publishing, media management, user administration, and site maintenance tasks through natural language.4723MIT
- AlicenseCqualityDmaintenanceEnables Claude Code to read, edit, and manage WordPress pages, posts, shortcodes, and media via the WordPress REST API.8012 npm3MIT
- FlicenseNot gradedqualityCmaintenanceEnables full WordPress operator access through Claude Code, including content, media, plugin/theme management, direct theme-file editing, backups, cache purging, and raw REST API calls, all secured with revocable tokens and no SSH requirement.1-
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants and agents to communicate directly with a WordPress environment, executing PHP code and WP-CLI commands, inspecting and editing theme and plugin files in a sandbox, and managing posts, content, and Gutenberg blocks in real time.MIT