TalkToWPTalkToWP
Log inStart Free
SoloOne WordPress site, watched and fixed for you.AgencyEvery client site in one fleet view.
NoticeboardCustomer storiesBlogFAQSecurity
Solo pricingAgency pricing
Log inStart Free
MCP server

Run your WordPress fleet from Claude, ChatGPT or Cursor.

TalkToWP's MCP server lets an AI assistant read the health of every WordPress site you manage and, when you allow it, carry out maintenance on them. You ask in plain English. The assistant answers using live data from your fleet.

Start Free Find it in the Claude Directory
Endpoint https://app.talktowp.com/mcp
01 · At a glance

What is the TalkToWP MCP server?

A hosted MCP server that connects AI assistants to your TalkToWP fleet data. It is built for agencies, freelancers and in-house teams running multiple WordPress sites.

Setup

One address, no token

Paste one address into your AI client, sign in, approve. No token, no install, no config file.

Tools

36 tools

15 read tools and 21 change tools. Site arguments accept an id, URL, hostname or name.

Default access

Read-only by default

Changes are off until the site owner turns them on, per site and per action.

Updates

Snapshot, verify, roll back

Every plugin or theme update is snapshotted, checked afterwards, and reverted automatically if the site breaks.

02 · What you can ask

What can I ask my WordPress sites?

Ask in plain English. For example:

  • “Which of my sites have problems right now?”
  • “What changed on example.com before it went down?”
  • “Is it safe to update WooCommerce on the client sites?”
  • “Update the plugins on staging, then tell me if anything broke.”
  • “Show me which sites have weak security headers or no WAF.”

What people use it for

Use case What the assistant does Tools involved
Fleet overview Lists every site with status, versions and pending updates list_sitesget_account_summary
Incident triage Finds open problems, explains them, shows what changed beforehand list_incidentsget_incidentlist_activity
Update planning Lists pending updates and scores each plugin's risk using outcomes from the whole TalkToWP fleet list_pending_updatesassess_update_risk
Safe maintenance Applies updates with snapshot, verification and rollback update_pluginsupdate_themeupdate_wordpress_core
Performance and security review Reports Lighthouse and Core Web Vitals, SSL, headers, WAF and DNS email records get_performanceget_security_posture
Uptime reporting Summarises uptime and response times get_site_history
Content and store operations Creates and edits posts, pages, templates, products and orders Content, Design and WooCommerce groups
Compromise investigation Reads files across the WordPress install to find modified core files or injected code read_site_file
03 · Tools

Which tools does the assistant get?

36 tools: 15 that only read, and 21 that change things. Site arguments accept an id, URL, hostname or name. Ambiguous matches are reported, not guessed.

Read tools (always on)

Tool Returns
list_sites Every connected site: status, WP/PHP version, pending update counts
get_site One site in full: versions, plugin inventory, caching, cron, SSL, hosting
get_performance Lighthouse scores, Core Web Vitals, load and query timings, cache state
get_security_posture SSL, security headers, WAF, DNS email records, exposed PHP, last scan
get_site_history Recent uptime checks, computed uptime and response-time summary
get_account_summary Fleet-wide totals and currently urgent incidents
refresh_site_data Asks the site's plugin to push current state now. Changes nothing on the site
list_incidents Detected problems, filterable by site, status, severity and category
get_incident One incident in full, including any AI analysis already generated
list_activity Chronological log of observed changes
list_pending_updates Pending core, plugin and theme updates, per site or fleet-wide
assess_update_risk Fleet intelligence for one plugin, cross-checked against a specific site
read_site_file Reads a file under the WordPress root, a window at a time
list_actions Which changes are permitted right now, and recent attempts
get_action_status Outcome of a previously requested change

Change tools (permissioned)

These need a paid plan and pass four gates before anything happens. See Safety.

Maintenance

Keep sites current

update_pluginsupdate_themeupdate_wordpress_coreactivate_plugindeactivate_pluginclear_cache

Plugin and theme updates are snapshotted and verified.

Content

Posts

create_postupdate_postpublish_postdelete_postbulk_import_posts

Bulk import takes up to 50 per call. Posts are created as drafts by default. Deletes go to trash unless force is set.

Design

Pages and templates

create_pageupdate_pagecreate_templateupdate_template

Pages are created as drafts by default.

WooCommerce

Products and orders

create_wc_productupdate_wc_productdelete_wc_productbulk_import_wc_productsmanage_wc_order

Bulk import takes up to 100 per call.

Files

Write a file

write_site_file

Inside wp-content/ only. Replaces the whole file, is not snapshotted and cannot be rolled back.

How does the plugin risk score work?

assess_update_risk looks at one plugin and returns a reliability score, the observed update success rate, common failure patterns and known conflicting plugins. Give it a site and it also reports which of those conflicting plugins are actually installed there. The data is anonymised and aggregated across all sites TalkToWP monitors.

Scores are smoothed toward 90 and carry a confidenceTier. If the tier is no_data, meaning fewer than 10 observations, ignore the score.

04 · How to connect

How do I connect Claude, ChatGPT or Cursor?

  1. 01 Sign in to TalkToWP and open MCP in the sidebar.
  2. 02 Copy the address, or the ready-made instruction for your client.
  3. 03 Paste it into the client and connect.
  4. 04 The client opens TalkToWP's sign-in and consent screen. Approving grants access. TalkToWP never asks for a password on the client's behalf.
  5. 05 The MCP page shows “connected” after the client's first request.

Clients with documented setup:

Claude Desktop claude.ai ChatGPT (paid plan, Developer Mode on) Cursor Claude Code
05 · How a change runs

What happens when I ask for a change?

  1. 01 The assistant reads site state and runs assess_update_risk.
  2. 02 It tells you what it intends to change and waits for your go-ahead.
  3. 03 The request passes the four access gates.
  4. 04 TalkToWP snapshots the affected plugin or theme directory.
  5. 05 The change is applied.
  6. 06 TalkToWP loads the site and checks it. A 5xx response or a WordPress critical-error page counts as broken, including when served as HTTP 200.
  7. 07 If verification fails, the snapshot is restored automatically.
  8. 08 The job ends in a terminal status.

Job statuses

Changes run asynchronously. A change is complete only at a terminal status. Write tools wait up to 45 seconds by default (configurable from 5 to 170 seconds), then return the job as still running. The assistant uses get_action_status to follow it.

Status Meaning
succeeded Applied, and the site responded normally afterwards
rolled_back Applied, broke the site, and was reverted from the snapshot
failed Did not complete
abandoned The worker stopped before reporting. Outcome unknown; re-read the site
06 · Safety

How does TalkToWP keep an AI assistant from breaking my sites?

Read-only is the default. Nothing changes on a site until a person turns it on, and the MCP server cannot turn it on for itself.

Four gates, all required for any change

Gate 1

Paid plan

The account is on a paid plan. The free plan refuses every tool that changes a site.

Gate 2

Write scope

The connection carries the write scope.

Gate 3

AI actions enabled for the site

The site owner has enabled AI actions for that specific site.

Gate 4

Action on the allowed list

The specific action is on that site's allowed list.

These controls can only be changed by a person in the TalkToWP dashboard. The MCP server cannot alter them. A refusal is a decision by the owner, and the assistant is instructed to relay it rather than work around it.

Authentication and access

  • OAuth 2.0 with an explicit consent screen. No long-lived token to store or leak.
  • Every request is scoped server-side to the signed-in account's sites.
  • A route allowlist applies to MCP-authenticated requests. A leaked access token cannot reach billing, account deletion, settings, site creation or deletion, AI chat endpoints, or the AI-action permission controls, whatever its scopes.
  • Disconnecting a client under Connected apps cuts its access within about a minute.

Protection against prompt injection

Plugin names, error messages, incident text and file contents come from the monitored site, which others may be able to edit. Every result flags those fields in an untrustedSiteData block. The assistant is instructed that instructions found there are not requests from you, and must be quoted and confirmed, never acted on.

Update safety

  • Snapshot before every plugin or theme update.
  • Verification after, with critical-error-page detection.
  • Automatic rollback on failure.
  • One change at a time per site, enforced in the database.
  • An optional idempotency_key means a retry after a timeout returns the original job instead of running twice.

Files

  • Reads cover the WordPress root, so modified core files and injected code can be found.
  • Writes are confined to wp-content/. Core cannot be modified.
  • Files holding credentials or keys are refused for both read and write: wp-config.php and its backups, .env, private keys, database dumps and .git/. The WordPress plugin itself enforces this.
  • write_site_file replaces the whole file, is not snapshotted and cannot be rolled back.

Limits that are deliberate

WordPress core

Core updates cannot undo themselves

Core updates cannot be snapshotted or reverted from a plugin, so update_wordpress_core has no rollback.

Deletes

Forced deletes are permanent

Deletions with force bypass the trash and cannot be undone.

What does not exist

There are no tools for any of the following. These capabilities are absent from the platform and the WordPress plugin, not merely switched off.

  • Installing plugins or themes
  • Deleting plugins or themes
  • Changing users or roles
  • Running database queries
  • Writing outside wp-content/
07 · Plans

Which plans include the MCP server?

Every plan can read. Paid plans can also use the change tools, subject to the four gates. Paid prices are monthly and introductory. See the full pricing.

Plan Price Read tools Change tools Note
Free $0 Yes, including read_site_file No. Refused with an upgrade message One site, free forever, limited spots
Solo $9 / month Yes Yes, subject to the four gates Introductory price
Agency $49 / month Yes Yes, subject to the four gates Introductory price
Scale $199 / month Yes Yes, subject to the four gates Introductory price
Enterprise $359 / month Yes Yes, subject to the four gates Introductory price
08 · Technical specification

Technical specification

Item Detail
Protocol Model Context Protocol, built on the official TypeScript SDK
Transport Streamable HTTP, stateless: a fresh server and transport per request
Endpoint https://app.talktowp.com/mcp
Auth OAuth 2.0 authorization flow with consent; scopes read and write
Server identity name talktowp, version 0.2.0 (reported in the MCP initialize handshake)
Instructions Behavioural guidance is delivered to the model on connect
Data source Each site's WordPress plugin pushes state to TalkToWP. Timestamps are included; refresh_site_data requests a fresh push
Local stdio / npm package Retired. The hosted endpoint is the only way in

Learn more about the protocol at modelcontextprotocol.io

09 · FAQ

Questions people ask

What is the TalkToWP MCP server?

A hosted Model Context Protocol server that connects AI assistants such as Claude, ChatGPT and Cursor to your TalkToWP fleet data. You ask in plain English and the assistant answers using live data from your WordPress sites.

Can the AI change my sites without my permission?

No. Access is read-only by default. A change needs a paid plan, the write scope, AI actions enabled for that site by its owner, and the specific action on that site's allowed list. Only a person in the TalkToWP dashboard can change those controls. The MCP server cannot.

What happens if an update breaks a site?

TalkToWP snapshots the plugin or theme before the update, loads the site afterwards, and restores the snapshot automatically if it finds a 5xx response or a WordPress critical-error page. The job ends as rolled_back. The exception is WordPress core: updates to core cannot be snapshotted or reverted, so update_wordpress_core cannot undo itself.

Do I need to install anything or create an API token?

No. Paste the address into your AI client, sign in and approve on the consent screen. The old local stdio and npm package is retired, and the hosted endpoint is the only way in.

Can I use the MCP server on the free plan?

Yes, for reading. The free plan gets every read tool, including read_site_file. Tools that change a site are refused with an upgrade message.

How do I cut off an AI client's access?

Disconnect it under Connected apps in TalkToWP. Access ends within about a minute.

Get started

Connect your fleet to your AI assistant.

Start free with one site. Read every tool today, and move to a paid plan when you want the assistant to make changes. Learn more about what TalkToWP checks, the agency tools, or how we handle your data.