Get the plugin
WP MCP/Integrations/WPML MCP

WPML MCP · Free and Pro

WPML MCP: keep your translation groups in order from a prompt.

A WPML MCP server lets an AI agent see which languages a post exists in and fix the links between translations, without opening the WPML language box on every post. WP MCP goes through WPML's own public API, and with Pro it can also draft a translated copy of a page for the model you connect to fill in.

Self-hosted · snapshot before every write · one-click undo

What it is

What a WPML MCP server does.

WPML records every translatable post in its icl_translations table with a language code and a translation group id, the trid. Two facts drive most multilingual chores: which language a post is in, and which posts belong to one group. A WPML MCP server exposes both, so an agent can find posts with no language, spot missing counterparts and link the right pages together.

WP MCP maps one neutral set of tools onto WPML, the same set that runs on Polylang, so an agent works the same way on either. We are plain about testing: WPML is a paid plugin that is not installed in the automated test environment, so these paths are written against its public API and have not been exercised against a live WPML install in CI.

Read and change

What WP MCP can read and change in WPML.

It can read

  • The site's WPML languages, with the default marked
  • A post's translation set, keyed by language code
  • With Pro: posts of a type and status with no translation into a language
  • With Pro: a page's translatable text as numbered segments, with a content hash

It can change

  • Set a post's language
  • Link posts as translations of each other
  • With Pro: create a translated draft linked into the source's group
  • With Pro: write translated text back, all segments or none
list-languagesget-post-translationsset-post-languagelink-post-translationsfind-missing-translationscreate-translation

These are the real ability and operation names the agent calls. TheWPML AI agent tool reference page lists the calls in detail.

Example prompts

Three things to ask first.

What languages is this WPML site set up for, and which is the default?

Link the English and German versions of the Contact page as translations.

List the published pages that have no French translation yet.

Safety

Every WPML write has a way back.

set-post-language and link-post-translations run through the snapshot wrapper, but WPML keeps languages and groups in its own icl_translations table, which the post snapshot does not capture, so undoing a WPML language or link change is not guaranteed. Read the result back with get-post-translations and fix a wrong link by linking again. In Pro, apply-page-text is one snapshotted change that rollback-operation restores.

Snapshot before every write

No tool that writes can skip it. The before-state is saved first, the change is applied second.

One-click undo

Restore a single change with rollback-operation or a whole agent run with rollback-session, from the agent or from wp-admin.

Drafts, and stale text refused

create-translation only makes a draft, so nothing goes live on its own. apply-page-text writes all segments or none, and refuses if the page changed since it was read unless force is set.

Free or Pro

Free, with more on Pro.

The four language tools (list-languages, get-post-translations, set-post-language and link-post-translations) are in the free plugin and need only edit_posts. The page translation workflow, find-missing-translations, get-page-text, create-translation and apply-page-text, is part of WP MCP Pro, which also keeps unlimited snapshot history with an active licence; the free plugin keeps the last 20.

WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.

How to connect

Connect WPML MCP in four steps.

  1. 01
    Install WP MCP

    Upload the free wpmcp plugin and activate it. It needs WordPress 6.9 or newer and PHP 8.1 or newer, and it runs entirely on your own server.

  2. 02
    Check the requirement

    WPML active. The page translation workflow needs WP MCP Pro.

  3. 03
    Connect your client

    Add the site to Claude Code, Claude Desktop, Cursor or any MCP client with a WordPress application password, or the WP-CLI stdio bridge locally. OAuth 2.1 with full or read-only access is there too, once the site owner switches it on.

  4. 04
    Ask for the change

    Describe what you want done in WPML. WP MCP snapshots the target, makes the change, and leaves a Restore button next to it in wp-admin.

Step-by-step guides: Claude,Claude Code andCursor. The docscover the safety model in full.

Frequently asked

WPML MCP: questions, answered.

What is WPML MCP?

It is WPML's language and translation model made readable and writable by AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client list languages, read and link translations, set a post's language and, with Pro, draft translated pages.

Is WPML MCP free?

The four language tools are free. Finding missing translations, reading page text, creating translated drafts and writing text back are Pro operations.

Can I use it for WPML AI translation?

Yes, in the sense that the model you connect does the translating. With Pro, the agent reads a page's text with get-page-text, makes a linked draft with create-translation and writes its translation back with apply-page-text. It is separate from WPML's built-in automatic translation, and the result is a draft for you to review.

Are WPML String Translation strings covered?

Not yet. The theme and plugin string operations work with Polylang; on WPML they answer string_translation_unsupported. WooCommerce Multilingual data is outside this integration too.

How well tested is the WPML path?

The mapping logic is unit-tested with fake data, but WPML is not installed in CI, so the live paths are best-effort against its public API. Try a bulk language change on a staging copy and read the result back with get-post-translations.

Does WPML MCP work with Claude, Claude Code and Cursor?

Yes. Claude Code and Cursor connect to WP MCP over HTTP with a WordPress application password, and Claude Desktop uses the desktop bundle from the WP MCP Connection screen. Clients that can only sign in with OAuth, such as the claude.ai custom connector, need OAuth switched on first with one line in wp-config.php, because it ships off. Once connected, the WPML tools are available in every client the same way.

Point your AI agent at WPML.