Integrations
MCP Server
Ask about your WordPress fleet from Claude, ChatGPT or Claude Code.
What the connector does, and what it won't
Applies to: All plans
Quick Start
You need a WP Admin Online account with at least one WordPress site connected. There are no API keys to create: you sign in with your account when you add the connector.
- Add the connector to your AI app using this server URL:
Server URL
https://www.wp-admin.online/mcp
- Claude (web, desktop and mobile): open Customize → Connectors, choose Add custom connector, paste the server URL and select Connect.
- ChatGPT: enable developer mode in Settings, create a new app and enter the server URL. ChatGPT detects the sign-in method on its own.
-
Claude Code: run the command below, then type
/mcpinside Claude Code to sign in.
Claude Code
claude mcp add --transport http wp-admin-online https://www.wp-admin.online/mcp
- Sign in and approve — your browser opens WP Admin Online. Sign in, review what the app is asking for and select Authorize.
- Start asking — ask about your fleet in plain language. The assistant picks the right tool for each question.
Capabilities
Tools
Eleven tools look things up and four start a background job. All of them are scoped to your account. Lookups and actions are separate tools, so your AI app can let you approve actions one by one.
| Tool | Type | Description |
|---|---|---|
| search_sites | Read-only | List or search your sites by name, URL or connection status |
| get_site | Read-only | One site in full: status, health score breakdown, versions, SSL and domain expiry, latest backup, plugins and themes |
| get_fleet_health | Read-only | Health score summary across all sites, with the sites that need attention |
| list_vulnerabilities | Read-only | Plugins and themes with known vulnerabilities, by severity, with the affected sites |
| list_available_updates | Read-only | Pending plugin and theme updates, grouped by component and target version |
| list_plugins | Read-only | Plugins installed across your sites, and which sites run each one |
| list_themes | Read-only | Themes installed across your sites, and where each one is active |
| list_site_backups | Read-only | Backup history for one site, including failures and the last successful backup |
| get_site_uptime | Read-only | 30 days of uptime, incidents and response times for one site |
| list_recent_activity | Read-only | Recent updates, logins and content changes, across all sites or for one |
| list_clients | Read-only | Your clients and how many sites each one has |
| trigger_sync | Action | Refresh a site's stored data from WordPress (plugins, themes, versions) |
| check_vulnerabilities | Action | Run a vulnerability scan on one site or on every connected site |
| recompute_health_score | Action | Recalculate a site's health score from current data |
| generate_report | Action | Email yourself a weekly or monthly client report, for one client or for each of them |
| create_backup | Action | Start a full backup of a site, or a quicker backup of its database only |
| create_backup_link | Action | Have the download link of a finished backup emailed to your account address. The assistant never sees the link |
What the connector does not do: it never installs updates, changes settings, deletes content or logs in to your WordPress sites. Those stay in the WP Admin Online dashboard, where updates run with snapshots and rollback. The actions only change data stored in your WP Admin Online account. A backup also has the connector plugin on the site read its files and database and upload them to backup storage; nothing on the site is changed.
Backups and downloads
Ask the assistant to back up a site, in full or its database only, and it starts the same backup the dashboard does. When the backup has finished, ask for its download and the link is emailed to your account address, exactly as when you press Download in the dashboard. The link works for 15 minutes.
The assistant never receives the link. A backup holds the whole site, so its link is kept out of the conversation and out of reach of anything else the AI app is connected to. One thing to keep in mind: an AI app that can also read your mailbox can read that email.
Resources
The same data is also published as MCP resources, for clients that can read them, such as Claude Code. Chat apps use the tools above.
| Resource | Description |
|---|---|
| fleet://sites | List all managed WordPress sites with status, health score, and update counts |
| fleet://sites/{site_id} | Detailed site info including plugins, themes, environment, and backup status |
| fleet://plugins/inventory | Fleet-wide plugin map grouped by slug with vulnerability and update status |
| fleet://themes/inventory | Fleet-wide theme map grouped by slug with vulnerability and update status |
| fleet://vulnerabilities/active | Active vulnerabilities across your fleet with affected sites and severity |
| fleet://updates/available | Pending plugin and theme updates grouped by slug and target version |
| fleet://clients | Client list with site counts for grouping sites by customer |
| fleet://activity/recent | Recent activity events across the fleet (updates, logins, changes) |
| fleet://sites/{site_id}/backups | Backup history and health for a specific site |
| fleet://sites/{site_id}/uptime | 30-day uptime time-series with daily percentages and response times |
| fleet://health-scores | Fleet-wide health score distribution with sites needing attention |
Example Prompts
Once connected, try these:
"Which of my sites need attention today?"
Health scores across the fleet, with offline, failing and low-scoring sites called out
"Which sites have critical vulnerabilities?"
Vulnerable plugins and themes by severity, with the sites running them
"What plugin and theme updates are pending across my sites?"
Pending updates grouped by plugin and version, vulnerable components first
"What changed on my fleet today?"
Recent updates, logins and content changes
"Show me the backup history and uptime for example.com"
Recent backups, any failures, and 30 days of uptime for one site
"Which sites are running WooCommerce, and on which version?"
Find the sites with a given plugin installed
"Trigger a sync of example.com"
Refresh the stored data for one site
"Generate this month's report for Client A"
Queue a client report, emailed to your account address
Authentication
The server uses OAuth 2.0 with PKCE. Your AI app sends you to WP Admin Online to sign in and approve access, then receives a token that is tied to your account. Your password is never shared with the AI app.
- Access is scoped to your user account — the assistant can only see and act on sites you own
- Access tokens last 30 days and are renewed automatically while the connector stays in use
- To disconnect, remove the connector in your AI app. To end its access on our side straight away, open Connected apps in your profile settings and disconnect it there
What your AI app receives
The approval screen lists everything the connector can read and start, and what the assistant looks up is sent to your AI app to answer you. That covers your sites with their plugins, themes, updates, vulnerabilities, backups, uptime and activity log, and your clients. Two of these include details about other people: the client list carries each client's name, company and email address (their contact details), and the activity log names the WordPress usernames behind logins and changes.
What we store for a connection and how we handle your data is described in the privacy policy.
Security
- Tenant isolation — every query is scoped to your user ID. No cross-account data leaks.
- No changes to your WordPress sites — no tool installs updates, edits settings or deletes content. The sync tool only asks your site for fresh data, and a backup only reads from it.
- Backup downloads go by email only — the assistant can ask for a backup's download link, but the link is emailed to your account address and never shown to the assistant.
- Trusted clients only — sign-in can only hand control back to Claude, ChatGPT or an app running on your own computer.
- Sign-in is for this server only — a sign-in that an AI app starts on behalf of a different server, or without saying which server it is for, is refused, so a look-alike connector cannot be given access to your account.
- Origin validation — browser-based MCP clients must originate from approved domains.
- Rate limits — each account can make up to 240 requests a minute.
- Transport — HTTPS only.
Transport
The MCP server uses Streamable HTTP transport at https://www.wp-admin.online/mcp.
It works with Claude, ChatGPT, and MCP clients that run on your own computer and sign in through your browser, such as Claude Code.
Local stdio transport is not supported because all operations require an authenticated user.
Troubleshooting
The connector will not connect
Check that the server URL is exactly https://www.wp-admin.online/mcp, then remove the connector and add it again to restart sign-in.
If your browser blocks pop-ups, allow them for your AI app so the sign-in page can open.
Sign-in was refused
If the sign-in page says the request does not say which server it is for, your AI app is signing in the older way, without naming the connector it is adding. Update the app to its latest version and add the connector again. If it says the request is for a different server, do not continue: something other than WP Admin Online asked for access to your account. Either way, contact support if it keeps happening.
The assistant says no sites were found
The connector only sees sites in the account you signed in with. Check that you approved access with the right account and that at least one site is connected in the dashboard.
A site shows out-of-date information
Ask the assistant to sync the site. The sync runs in the background and the data refreshes within a few minutes.
An action was skipped
Asking for the same action again straight away does not queue it twice. A site can be synced or have its health score recalculated once a minute, a vulnerability scan runs at most once every 5 minutes per site (10 minutes for all sites at once), and the same report is sent at most once every 10 minutes. A site can be backed up through the connector once every 15 minutes (10 backups an hour for the account), and the download link for the same backup can be requested once every 10 minutes (10 links an hour). The assistant tells you when it can be requested again.
No report was queued for a client
A report is written about the sites that are connected and not paused. A client with no such site gets no report, and the assistant says so instead of promising an email that would never arrive.
Client reports are not available
Report generation depends on your plan. The assistant will tell you when the account's plan does not include it.
Still stuck?
Contact support or email [email protected], and tell us which AI app you are using and what you asked.
FAQ
What is MCP?
The Model Context Protocol is an open standard for connecting AI assistants to external tools and data sources. It lets an assistant read your fleet data and start actions without you needing to copy-paste or navigate between screens.
Is my data safe?
All data is scoped to your authenticated user account, so an assistant can only see and act on sites you own. It cannot modify your WordPress sites, install updates or change settings. What it can do is queue a data sync, a vulnerability scan, a health score recalculation, a client report or a backup in your WP Admin Online account, and have a backup's download link emailed to you.
Which AI apps can I use?
Claude (web, desktop and mobile), ChatGPT, and MCP clients that run on your own computer and sign in through your browser, such as Claude Code. Other hosted apps cannot sign in yet; tell us if you need one added. Whether you can add a custom connector depends on your plan with each provider.