My Site Hand – AI Assistant, Site Health & MCP Server for WordPress

Сүрөттөө

My Site Hand finds what is wrong with your WordPress site, and helps you fix it.

Activate the plugin and it scans your site straight away. No token, no API key, no Node.js, no terminal. About thirty seconds later you get a health score out of 100 and a list of real problems on your own site — and you can repair most of them inline, right there in the report.

🔍 The Site Health Scan (no setup required)

Twelve checks, run one at a time so nothing times out.

• Broken links — checks the links in your recent posts and pages, and reports only the ones that are genuinely gone. Anything ambiguous is left alone rather than reported as a false alarm.
• Missing alt text — images your visitors using screen readers cannot see, and search engines cannot read.
• Missing meta descriptions — published posts and pages with no SEO description, for Yoast SEO and RankMath.
• Oversized media — files big enough to slow your pages down, with the space you would get back.
• Orphaned files — uploads that nothing on your site appears to use.
• Plugin and core health — pending updates, an unsupported PHP version, missing HTTPS, errors visible to visitors, a stalled cron.
• Images missing dimensions — the cause of pages that jump around while they load, which Google measures as a Core Web Vital.
• Images missing lazy loading — pictures further down a post that something has opted out, so visitors download them before they are ever seen.
• Exposed WordPress files — readme.html, license.txt and a debug log left publicly readable. The first hands an attacker your exact version; the last can contain server paths and credentials.
• XML-RPC — reported as a notice, with the tradeoff stated plainly. It is a brute-force vector, but the WordPress mobile app and Jetpack need it, so this is only worth turning off if you use neither. Sites running Jetpack are skipped entirely.
• Thin content — published pages with very few words. Read with judgement: a contact page is supposed to be short, and pages built from a shortcode, gallery or embed are left out.
• Accessibility basics — links that announce nothing to a screen reader, “click here” links, more than one main heading, and headings that skip a level. Structural checks only; it does not claim to be a full audit.

⚡ Quick Fix

A list of complaints is not much use on its own. Write alt text straight into the report, replace a dead link, or trash a file you no longer need — one row at a time, with the score climbing as you go. No AI and no API key required for any of it.

Your score is kept over time, so you can watch the site improve, and you can have a short report emailed to you when something changes.

📤 Send the report to someone else

A report is more useful when the person who needs to act on it can read it.

• PDF — opens a clean, printable page and your browser’s own print dialog. Choose “Save as PDF”. No bloated PDF library bundled into the plugin to do a job your browser already does well.
• CSV — every issue as a row: check, severity, issue, context, link and object ID. Opens correctly in Excel and Google Sheets, in any language.
• A shareable link — a public web page your client can open without a login, with an expiry you choose: 7, 30 or 90 days. There is no never-expires option.

Shared reports are redacted on purpose. They show the score, each check by name, and how many issues it found. They never show file names, page addresses, server paths, post or media IDs, edit links, or your plugin, theme, PHP and WordPress versions — and the two security checks are left out entirely, because publishing those would be publishing a vulnerability report about your own server. The page tells you exactly what a recipient will and will not see before you create the link, every link can be revoked instantly, and the report is a snapshot: re-scanning your site never changes what you already sent.

🤖 And when you want an AI to do the work

Everything above works on its own. Connecting an AI assistant is the optional upgrade.

Built on the open standard Model Context Protocol (MCP) developed by Anthropic (the creators of Claude), this plugin securely exposes safely-gated capabilities (Abilities) to clients like Claude Desktop, Cursor, and VS Code, so they can work on your site using plain language.

🚀 What an AI assistant can do for you:

• Write & Edit Content – Ask Claude to draft, edit, format, or publish posts and pages directly on your site.
• AI-Driven SEO Audits – Let your AI scan Yoast or RankMath metadata, optimize it for targeted keywords, and update titles/descriptions instantly.
• WooCommerce Store Management – Ask your AI to list low-stock items, draft product listings, check recent orders, or summarize sales analytics.
• Site Health & Diagnostics – Let the AI inspect PHP error logs, check loopback status, or look up site details to debug issues.
• Zero-Config Automated Setup – No manual editing of hidden JSON config files. Copy a single command from your WordPress dashboard, paste it into your terminal, and Claude connects automatically!
• Total Safety & Security – All tokens are SHA-256 hashed. You can toggle specific abilities (like writing or deleting) on/off with simple switches, and monitor everything the AI does in real-time with the built-in Audit Log.

📦 Included Modules:

1. Content — posts, pages and custom post types (9 abilities)
2. SEO — analysis and meta management, for Yoast SEO and RankMath (6)
3. Diagnostics — site health, error logs, cron and database details (7)
4. Media — the media library, including alt text (6)
5. Users — accounts and roles (5)
6. WooCommerce — products, orders and coupons (12, registers only when WooCommerce is active)

That is 33 abilities on a standard install, or 45 with WooCommerce. Every one of them is an individual switch, and a token can only call what you allow.

🔒 Security

• API tokens are SHA-256 hashed — the raw token is shown once and never stored.
• Every token is scoped to specific abilities. A token can only do what you explicitly allow.
• Optional IP allowlist restricts a token to specific addresses or CIDR ranges.
• Tokens are sent via the Authorization header, never in the URL.
• Every action is written to a searchable audit log with configurable retention.

⚠️ Important Requirements (Honest & Transparent):

The Site Health scan and Quick Fix need none of the following. They apply only if you choose to connect an AI assistant:

• Node.js: The automated desktop bridge (mcp-remote) requires Node.js installed on your local computer to run.
• SSL/HTTPS: For security, your site must run on HTTPS so your API tokens remain encrypted in transit.
• Administrator Access: You must be an administrator to generate API tokens and toggle module permissions.

External Services

Link Checker (SEO Module)

When the check-broken-links ability is called via the MCP API, this plugin sends HTTP HEAD requests to URLs found in your post content to verify they are reachable. No personal user data is transmitted — only a standard HTTP request is made to each URL being checked. This is triggered only when explicitly called by an authorized API token holder.

Link Checker (Site Health scan)

The Broken Links check in the Site Health scan sends HTTP HEAD requests (and, where a server refuses HEAD, a single ranged GET) to the links found in your 50 most recent published posts and pages, to see whether they still resolve. The request identifies this plugin and your site URL in its user agent. No personal user data is transmitted. Results are cached for 12 hours. This runs when you start a scan from the admin, and during the scheduled scan if you leave that enabled — on sites with more than 500 published posts the link check is skipped on the schedule. Turning scheduled reports off in My Site Hand → Settings stops the scheduled scan entirely.

Requests this plugin makes to your own site

The Exposed WordPress Files and XML-RPC checks ask your own site, over HTTP, whether /readme.html, /license.txt, /wp-config-sample.php, /wp-content/debug.log and /xmlrpc.php answer to an anonymous visitor. These are loopback requests to your own domain, not to any third party, and no data is sent in them. Results are cached for 12 hours. If your host blocks loopback requests, both checks report that they could not run rather than reporting your files as safe.

Shared report links

Creating a share link stores a redacted snapshot of your scan in your own database and serves it from your own site at a tokenized URL. Nothing is uploaded anywhere. The page is sent with X-Robots-Tag: noindex, nofollow, every link expires, and you can revoke one at any time.

No data is sent to any third-party analytics or tracking service by this plugin.