FatalGuard MCP server
Commit Nov 10, 2026Allows AI clients to read WordPress PHP error logs, debug logs, and fatal error details via a read-only MCP server.
Also known as zinoodev85/fatalguard
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 1.3.2
- Last commit
- Nov 10, 2026
- License
- GPL-2.0
What is FatalGuard MCP?
FatalGuard allows AI clients to read WordPress PHP error logs, debug logs, and fatal error details via a read-only MCP server. It exposes 6 tools, such as status, list_log_sources, tail_log.
Summary generated from the project's README
About FatalGuard MCP server
Debugging WordPress PHP errors and fatal crashes from inside an AI assistant is what FatalGuard enables. This read-only MCP server allows developers to connect tools like Claude, Cursor, or VS Code directly to their website's error logs. By using a streamable HTTP endpoint and a unique API key provided in the WordPress admin dashboard, your AI client can inspect site health without needing manual log exports.
The server provides six specific tools to facilitate troubleshooting. You can use list_log_sources to see available files, tail_log to view recent entries with secrets redacted, or list_errors to see grouped issues. For critical failures, list_recent_fatals and get_fatal provide deep insights into the specific errors causing white screen crashes. Because the server is read-only, the AI can only observe and report on errors without making any changes to your site configuration or files.
What you can do with it
- 1Identify site-crashing errorsAsk your AI client to find the specific fatal error causing a critical error white screen.
- 2Monitor recurring warningsHave an AI assistant scan through logs to find which PHP warnings are appearing most frequently.
Written from the project's README. Every use case is checked against a quote from it.
How to install FatalGuard MCP
FatalGuard gives each account its own endpoint, so there is no address to copy here. Get yours from the provider, put it in place of the part in braces, and add it to your client as a remote server.
https://{site}/wp-json/fatalguard/v1/mcp
FatalGuard MCP tools 6
Detected from the READMEstatuslist_log_sourcestail_loglist_errorslist_recent_fatalsget_fatal
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablezinoodev85/fatalguard is public and reachablegithub.com/zinoodev85/fatalguard ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)GPL-2.0spdx.org/licenses/GPL-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/zinoodev85/fatalguard ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeEndpoint did not answer initialize: unreachableFinding
README
View on GitHubFatalGuard — PHP error log viewer, fatal error alerts and MCP server for WordPress
FatalGuard is a WordPress plugin. It shows your debug.log and PHP error log in wp-admin,
catches the fatal error behind the "critical error" white screen, sends Telegram alerts with
a one-tap recovery link, and runs its own read-only MCP server, so Claude, Cursor or
VS Code can read your site's errors.
This repository is a read-only mirror of the free plugin, version 1.3.2. Development happens elsewhere; issues and questions go to the support forum.
Install
Install it from wordpress.org, so your site gets automatic updates:
- In wp-admin: Plugins → Add New, search for "FatalGuard", Install, Activate.
- Or download it from https://wordpress.org/plugins/fatalguard/.
A zip from this repository works too (Plugins → Add New → Upload Plugin). It uses the
same slug and has no Update URI header, so WordPress updates it from wordpress.org.
Connect an AI client (MCP)
- In wp-admin, open FatalGuard → AI (MCP) and press Generate API key. Copy the key: it is shown only once. The same page shows these snippets with your URL and key filled in.
- Add the server to your client. Replace
example.comwith your site and paste your key.
Endpoint: POST https://<your-site>/wp-json/fatalguard/v1/mcp (streamable HTTP).
The key goes in the X-FatalGuard-Key header. Some Apache hosts strip
Authorization: Bearer, so use this header.
Claude Code (run in your terminal)
claude mcp add --transport http fatalguard "https://example.com/wp-json/fatalguard/v1/mcp" --header "X-FatalGuard-Key: PASTE-YOUR-API-KEY-HERE"
Cursor — mcp.json
{
"mcpServers": {
"fatalguard": {
"type": "http",
"url": "https://example.com/wp-json/fatalguard/v1/mcp",
"headers": {
"X-FatalGuard-Key": "PASTE-YOUR-API-KEY-HERE"
}
}
}
}
VS Code — .vscode/mcp.json
{
"servers": {
"fatalguard": {
"type": "http",
"url": "https://example.com/wp-json/fatalguard/v1/mcp",
"headers": {
"X-FatalGuard-Key": "PASTE-YOUR-API-KEY-HERE"
}
}
}
}
Claude Desktop — claude_desktop_config.json (via mcp-remote)
{
"mcpServers": {
"fatalguard": {
"command": "npx",
"args": [
"mcp-remote",
"https://example.com/wp-json/fatalguard/v1/mcp",
"--header",
"X-FatalGuard-Key: PASTE-YOUR-API-KEY-HERE"
]
}
}
}
Then ask: "What's crashing my site?" or "Which warnings keep coming back?"
Tools
All six are read-only. The AI cannot change anything on your site.
| Tool | What it returns |
|---|---|
status |
Logging status and FatalGuard settings |
list_log_sources |
The logs FatalGuard can read, with size |
tail_log |
The newest lines of one log, secrets redacted |
list_errors |
Errors grouped with counts and last seen |
list_recent_fatals |
Recently captured fatal errors |
get_fatal |
One fatal error in detail |
The server works while WordPress can still load. For a site that is fully down, use the recovery link from the fatal alert. Revoke the key at any time on the same page.
Try it without a site (Docker)
The repository builds a sandbox: a throwaway WordPress (SQLite, no web server) with FatalGuard active and some demo errors, speaking MCP over stdio.
docker build -t fatalguard-mcp . && docker run -i --rm fatalguard-mcp
It is a demo to see the tools and their answers. Real use is the plugin on your own site, connected as shown above.
License
GPLv2 or later. See LICENSE.txt.
FatalGuard MCP questions
What tools does FatalGuard MCP provide?
It exposes 6 tools, including status, list_log_sources, tail_log, list_errors, list_recent_fatals.
Can the AI change settings on my WordPress site?
No, all tools provided by the server are read-only, ensuring the AI cannot modify your site.
What happens if my site is completely down?
If the site is fully down, you should use the recovery link provided in the fatal error Telegram alert.