WPConvert MCP server

WPConvert Devtools

Open-source developer tools for turning AI-built websites into WordPress themes from your terminal, API, or AI assistant.

WPConvert does not modify your source project and does not require WordPress credentials. Output is either theme.zip (paid) or a WordPress Playground preview URL (~10 minutes).

The CLI and MCP server are open source. The WPConvert conversion engine runs on WPConvert.ai and requires an API key. Free verified accounts can create preview-only developer conversions; downloading theme.zip requires PRO, Agency, or PAYG credits.

Agent quickstart (MCP)

If you are a coding agent in Cursor, Claude Desktop, or another MCP host, use the MCP tools (do not shell out to the CLI in the same session).

1. Configure @wpconvert/mcp — see examples/mcp/ and docs/agents.md
2. wpconvert_quota — inspect capabilities before converting
3. wpconvertconvertfolder → wpconvertcheckstatus → wpconvertdownloadresult or wpconvertcreatepreview

Portable Skill: skills/wpconvert/SKILL.md

MCP setup (Cursor / Claude Desktop)

Current release: @wpconvert/mcp@0.3.1 (npx -y @wpconvert/mcp uses npm latest; pin @0.3.1 for deterministic installs).

{
  "mcpServers": {
    "wpconvert": {
      "command": "npx",
      "args": ["-y", "@wpconvert/mcp@0.3.1"],
      "env": {
        "WPCONVERT_API_KEY": "wpc_live_EXAMPLE_ONLY_NOT_A_REAL_KEY"
      }
    }
  }
}

Optional: set WPCONVERTAPIBASE to point at a non-default API host (testing only).

See docs/mcp.md and docs/agents.md for the full agent workflow.

This repository contains the open-source WPConvert developer tools:

These tools are thin clients that call the hosted API over HTTPS.

What this repo is NOT

This repository does not include the WPConvert conversion engine, backend workers, AI prompts, parser/mapper logic, billing/quota logic, or theme generation system. Those run on WPConvert.ai servers.

Requirements

• Node.js >= 18
• A WPConvert API key (wpclive...) from your dashboard (Settings → API & CLI)
• PRO/Agency or PAYG credits for full conversions with theme.zip download
• Free verified accounts can run up to 3 lifetime preview-only developer conversions (Playground preview, no ZIP)
• CLI, API, and MCP use the same credits as dashboard conversions for paid exports (1 credit per successful conversion; failed conversions are refunded)

Free developer previews

Shortened. The full README is on GitHub.