AI agents (MCP)

Tranzly for AI agents

Your WordPress site is its own MCP server. An AI assistant signs in as a WordPress user with an application password and can do what that user may do with Tranzly — nothing more.

73 actions: 53 free, 20 in Pro.

Developer reference: every action, its REST route and its parameters

Set it up in three steps

  1. Check the switch

    You need WordPress 6.9 or later and Tranzly 3.19.0 or later. In the plugin’s settings, “Allow AI agents (MCP)” is on unless you turned it off.

  2. Create an application password

    In WordPress, open Users, then Profile, and add an application password named after your AI app. Copy it: WordPress shows it once.

  3. Add the site to your AI app

    Use your WordPress username, the application password and your site’s connection address:

https://example.com/wp-json/tranzly/v1/mcp

Configuration for popular AI apps

Every app below talks to your site through the official WordPress proxy, @automattic/mcp-wordpress-remote. Replace the address, username and password with yours.

Claude Desktop

JSON
// claude_desktop_config.json
{
  "mcpServers": {
    "tranzly": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/tranzly/v1/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

Claude Code

Bash
claude mcp add tranzly \
  -e WP_API_URL=https://example.com/wp-json/tranzly/v1/mcp \
  -e WP_API_USERNAME=your-username \
  -e WP_API_PASSWORD=your-application-password \
  -- npx -y @automattic/mcp-wordpress-remote@latest

Cursor

JSON
// .cursor/mcp.json
{
  "mcpServers": {
    "tranzly": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/tranzly/v1/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

VS Code

JSON
// .vscode/mcp.json — VS Code's key is "servers"
{
  "servers": {
    "tranzly": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/tranzly/v1/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

Claude and ChatGPT (sign in)

Add the connection address as a custom connector in Claude, or as a custom MCP server in ChatGPT. They open your site so you can approve them as a WordPress user, with no application password to copy. Your site needs pretty permalinks.

Other apps

Any app that supports MCP servers over standard input and output can use the same command and settings. Apps that only connect to remote HTTP servers can reach the connection address directly with the same username and application password.

What an AI agent can do

Everything the plugin’s own screens can do. Actions marked Pro need a Tranzly Pro licence.

Free edition

  • Cancel a job (Free) — Stops a job; translations already made are kept.
  • Connect to support (Free) — Connects this site to Zinn Digital® support (name, email, consent).
  • Correct a translation (Free) — Saves corrected segments of a translation (segments: key to text); corrected text is protected from re-translation.
  • Start a translation job (Free) — Starts a background job translating listed posts (posts) or a whole post type into languages (langs).
  • Create an empty translation (Free) — Creates a draft translation of a post in a language (lang) to write by hand, without an engine.
  • Create a term translation by hand (Free) — Creates a term’s translation in a language with a name, slug and description you give.
  • Disconnect from support (Free) — Disconnects this site from support.
  • Estimate a translation (Free) — Estimates characters and cost to translate posts (posts or post_type) into languages (langs) with an engine, before spending anything.
  • Translate what is missing (Free) — Queues translation of every missing (or out-of-date) item in a language and post type.
  • Read the DeepL usage (Free) — Returns the characters used and the limit of the saved DeepL key this month.
  • Read the site diagnostics (Free) — Returns the diagnostics a support ticket would carry: versions, active plugins, limits and recent errors.
  • Read the display options (Free) — Returns the language switcher and credit display options.
  • Read the engine settings (Free) — Returns the default and fallback engine, per-language engines and AI models, each engine’s state, the connected AI providers with their models, and this month’s spend.
  • Read the integrations (Free) — Lists the SEO, WooCommerce, page-builder and form plugins Tranzly supports and which are active here.
  • Read a job’s progress (Free) — Returns one job’s progress and counts.
  • Read a job’s failures (Free) — Lists a job’s failed items with the reason for each.
  • Read the Tranzly 2.x import (Free) — Returns the state and report of importing translations from Tranzly 2.x.
  • Read the licence (Free) — Returns this site’s Tranzly plan, licence state, renewal date and what the plan includes.
  • Read the menus per language (Free) — Returns which menu each language shows in each menu location.
  • Read a post’s translations (Free) — Lists a post’s translation group: every language’s member with its title, status and edit link.
  • Read a translation side by side (Free) — Returns a translation’s segments beside the original’s, for review and correction.
  • Read theme and plugin texts (Free) — Returns the theme and plugin texts (scope) in a language with their translations.
  • Read the site’s texts in a language (Free) — Returns the site title, tagline and widget texts in a language.
  • Read the support connection (Free) — Says whether this site is connected to Zinn Digital® support, and as whom.
  • Read a term’s translations (Free) — Lists a category’s or tag’s translation group.
  • Read the address settings (Free) — Returns how languages appear in addresses (folder, subdomain or domain), translated slugs and bases, and noindex for untranslated pages.
  • Link an existing post as a translation (Free) — Makes an existing post (target) the translation of this post in a language.
  • Link an existing term as a translation (Free) — Makes an existing term (target) the translation of this term in a language.
  • List translation engines (Free) — Lists the translation engines, whether each is set up, and which one is used when none is named.
  • List translation jobs (Free) — Lists background translation jobs, newest first, with progress.
  • List languages (Free) — Lists the site’s languages. The first one is the language the original content is written in.
  • List what is missing or out of date (Free) — Lists originals with their translation state in a language (state: missing, stale, current), page by page.
  • Open a support ticket (Free) — Files a support ticket (subject, message, kind, email), with this site’s diagnostics when the administrator agreed. It never creates a login or sends one.
  • Consent to support diagnostics (Free) — Records the administrator’s consent to send diagnostics with support tickets.
  • Retry or hand off a failed item (Free) — Retries a failed item (action: retry, optionally with another engine) or marks it for translating by hand (action: by-hand).
  • Import Tranzly 2.x translations (Free) — Runs the 2.x import: dry-run (report only), run, or undo.
  • Save an engine key (Free) — Saves the API key (and region for Microsoft) of DeepL, Google or Microsoft; empty removes it. Keys are stored encrypted and never returned.
  • Set the menus per language (Free) — Assigns a menu per language per location (map).
  • Protect or unlock a translation (Free) — Protects a translation from being overwritten by the engine (protected: true), or unlocks it.
  • Correct theme and plugin texts (Free) — Saves corrected translations of theme and plugin texts (strings); they become protected.
  • Translate a site text (Free) — Saves one site text (key) in a language, e.g. the site title or tagline.
  • Change the address settings (Free) — Sets the address mode (mode), per-language domains, translated bases and segments, noindex_untranslated and slug suggestions.
  • Start the free Pro trial (Free) — Starts the 14-day Tranzly Pro trial for this site (no payment needed).
  • Translate an image’s text (Free) — Saves an image’s alt text, title or caption (field) in a language (lang).
  • Translate a post or page (Free) — Translates one post or page into one or more of the site’s languages with a translation engine, creating each translation or updating it. New translations are drafts unless publish is true. A translation a person edited is skipped unless force is true.
  • Translate missing theme and plugin texts (Free) — Translates the next page of untranslated theme and plugin texts in a language with the default engine (repeat with after until done).
  • Translate a category or tag (Free) — Translates one term (category, tag or product attribute) into a language (lang) with an engine, creating or updating its translation.
  • Translation status (Free) — With a post ID: each language’s translation of that post, whether it is out of date, and who wrote it. Without one: how much of the site is translated, per language.
  • Unlink a post from its translations (Free) — Takes a post out of its translation group; it keeps its language.
  • Unlink a term from its translations (Free) — Takes a term out of its translation group.
  • Change the display options (Free) — Changes the switcher (style, flags, names, placement) and the credit line.
  • Change the engine settings (Free) — Sets the default engine, a fallback engine, per-language engines and per-language AI models (default, fallback, per_lang, models, caps). Everything but the default engine is Pro.
  • Change languages and settings (Free) — Sets the site’s languages (languages: list of code and name; the first is the original language), the front-end class prefix, and whether AI agents (MCP) are allowed.

Pro edition

  • Translate the whole site (Pro) — Starts background translation jobs for every original of the given content types (all translated types when none are given): the missing translations, the out-of-date ones, or all of them. Returns the jobs started, one per language.
  • Check a translation with AI (Pro) — Has AI compare one translation with its original and score it, and stores the report on the translation. Uses the quality-check AI model set in Tranzly’s workflow settings.
  • Estimate translating the site (Pro) (Pro) — Estimates a whole-site translation in a language (post_types, scope, engine) before starting it.
  • Export a file for human translators (Pro) — Returns an XLIFF or CSV file (as text) with the originals and their translations in one language, for a translator or a translation agency: the given posts, or a page of up to 100 originals of a content type in a state (missing, stale, translated or all; repeat with after). The same file can be imported back once translated.
  • Read comment handling (Pro) (Pro) — Returns whether comments are shared across languages or kept per language.
  • Read the glossary (Pro) — Returns the words never translated, the fixed term translations and the tone per language.
  • Read a quality report (Pro) (Pro) — Returns a translation’s AI quality report: score and the segments it flagged.
  • Read the workflow settings (Pro) (Pro) — Returns auto-translation on publish and on update, review before publish, and the AI quality check’s threshold, provider and model.
  • Migrate from WPML, Polylang or TranslatePress (Pro) (Pro) — Imports the next page of translations from another multilingual plugin (mode: dry-run or run; cursor).
  • Write an imported file (Pro) (Pro) — Writes the next page of posts from an uploaded translation file (repeat with after until done).
  • List plugins to migrate from (Pro) (Pro) — Lists WPML, Polylang and TranslatePress data found on this site that can be imported.
  • List theme and plugin text sources (Pro) (Pro) — Lists the themes and plugins whose texts can be scanned for translation, and how many strings each has.
  • Approve or reject a translation (Pro) (Pro) — Approves a translation (and publishes it when the original is published) or sends it back (decision, note).
  • Scan a theme or plugin for texts (Pro) (Pro) — Scans the next page of a component’s PHP files for translatable texts (repeat with after until done).
  • Check translations with AI (Pro) (Pro) — Schedules the AI quality check of the next page of a language’s translations (or the given posts).
  • Multilingual SEO audit (Pro) (Pro) — Checks translations for missing SEO titles, descriptions, slugs and hreflang in a language, page by page.
  • Change comment handling (Pro) (Pro) — Shares comments across a post’s translations or keeps them per language (mode).
  • Update the glossary (Pro) — Replaces the parts of the glossary you send (words never translated, term translations, tone); parts you leave out are kept. Used by every engine from the next translation on.
  • Change the workflow settings (Pro) (Pro) — Sets on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider and quality_model.
  • Import a translated file (Pro) (Pro) — Uploads a Tranzly XLIFF or CSV file (content, filename) translated elsewhere; answers a token that identifies the upload for the import.

Guided workflows

The server also offers ready-made workflows your AI app lists as prompts:

  • Translate my site (Free) — A guided workflow: the agent checks the languages and engine, estimates the cost, and translates what is missing, asking before it spends or publishes.

Safe by design

Each action checks the same WordPress permission as the plugin’s own screen, for the exact page or post it touches. A subscriber cannot connect at all.

Application passwords can be revoked at any time under Users, Profile, without changing your normal password.

Turn “Allow AI agents (MCP)” off and the actions and the connection address disappear from the site.

Pages an agent changes keep their WordPress revisions, so any change can be undone.

Hosted with Zinn Digital®?

If Zinn Digital® hosts the site, our own MCP server can use these actions for you without an application password: connect your AI app to the Zinn Digital® MCP server and use wordpress_abilities_list and wordpress_ability_run.

The Zinn Digital® MCP server