How do I install WPConvert MCP?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does WPConvert MCP need an API key?

The publisher lists these environment variables: WPCONVERT_API_KEY.

What transport does WPConvert MCP use?

WPConvert MCP is reached over HTTP.

When was WPConvert MCP last checked?

Last checked 2026-11-07. Convert websites to WordPress themes: connect by URL or run locally; preview, buy, download.

WPConvert MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.wpconvert.ai/mcp

Credentials from the publisher

WPCONVERT_API_KEY — Optional WPConvert API key from Settings → API & CLI on wpconvert.ai. Without it, the agent offers a link for free guest previews or browser sign-in.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http ai.wpconvert-mcp https://mcp.wpconvert.ai/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ai.wpconvert-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.wpconvert.ai/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.4.1

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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. No API key is needed to try it: a quick browser check gives a few free guest previews, and browser sign-in creates a key for you. Downloading theme.zip requires Starter (one theme), PRO, Agency, or PAYG credits, which you can buy from the terminal or the agent.

Agent quickstart (MCP)

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

Configure @wpconvert/mcp — see examples/mcp/ and docs/agents.md
wpconvert_quota — inspect capabilities before converting (no key yet? wpconvert_connect)
wpconvert_convert_folder → wpconvert_check_status → wpconvert_download_result or wpconvert_create_preview
To download a preview or get a plan: wpconvert_plans → the user picks → wpconvert_checkout

MCP tool	Purpose
`wpconvert_quota`	Capabilities, credits, `recommended_next`
`wpconvert_convert_folder`	Zip folder + start conversion
`wpconvert_check_status`	Poll job status
`wpconvert_download_result`	Download `theme.zip` when allowed
`wpconvert_create_preview`	Playground URL when preview-only
`wpconvert_explain_failure`	Failure reason + recovery
`wpconvert_connect`	Link + code for free guest previews (`guest`) or browser sign-in (`login`); the user opens it
`wpconvert_connect_status`	Whether the user finished the link; how WPConvert is connected
`wpconvert_plans`	Every option (Starter, Pro, Agency, PAYG) with what it includes and today's price
`wpconvert_checkout`	Stripe link for the option the user picked; the user pays

Portable Skill: skills/wpconvert/SKILL.md

MCP setup (Cursor / Claude Code / Claude Desktop)

Current release: @wpconvert/[email protected] (npx -y @wpconvert/mcp uses npm latest; pin @0.4.0 for deterministic installs).

Claude Code — one command, no config file, no key:

claude mcp add wpconvert --scope user -- npx -y @wpconvert/[email protected]

--scope user makes it available in every project. Confirm with claude mcp list (wpconvert … ✔ Connected) or /mcp in a session. Then ask the agent to convert a folder; it gives you a link for free guest previews or to sign in.

Cursor / Claude Desktop:

{
  "mcpServers": {
    "wpconvert": {
      "command": "npx",
      "args": ["-y", "@wpconvert/[email protected]"]
    }
  }
}

Optional env: WPCONVERT_API_KEY to use an existing key (for Claude Code, add -e WPCONVERT_API_KEY=wpc_live_EXAMPLE_ONLY_NOT_A_REAL_KEY after --scope user), and WPCONVERT_API_BASE for 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:

Package	Description
`wpconvert`	CLI — convert a local folder to a WordPress theme
`@wpconvert/mcp`	MCP server — convert from Cursor, Claude Code, Claude Desktop, or other MCP clients
`examples/`	API usage examples (curl + Node.js)
`docs/`	CLI, MCP, API reference, and agent integration guide
`openapi.yaml`	Machine-readable OpenAPI 3.1 Developer API contract (mirrored from production)

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
Optional: a WPConvert API key (wpc_live_...) from your dashboard (Settings → API & CLI), or let wpconvert login / wpconvert_connect create one through browser sign-in
Guest previews without an account: a few WordPress Playground previews for 24 hours after one browser check; buy one with Starter to download it
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

Free verified WPConvert accounts can create up to 3 lifetime developer previews from the CLI, API, or MCP. Preview-only conversions generate a WordPress Playground preview, but theme ZIP downloads are locked. To download theme.zip, upgrade to PRO/Agency or add PAYG credits, then re-run the conversion.

Preview-only jobs are never retroactively downloadable — upgrading does not unlock an old job; convert again after upgrading.
On success, wpconvert convert automatically creates a Playground preview URL.
Preview-only jobs auto-open your browser by default (the preview is the deliverable).
Use --no-open in CI/headless, or --no-preview to skip Playground entirely.

Expected preview-only CLI output

wpconvert convert . --type theme

Scanning /path/to/project ...
Packaging zip ...
Zip built: 1.2 MB compressed.
Uploading (multipart) and starting conversion ...
✔ Conversion queued: abc123-def456
Free developer preview 1 of 3.
Download locked. Upgrade to PRO or add PAYG credits, then re-run this conversion to download theme.zip.
  … processing 42%
✔ Conversion complete.
Download locked. Upgrade to PRO or add PAYG credits, then re-run this conversion to download theme.zip.
Creating Playground preview ...
✔ Preview ready (WordPress Playground):
  https://playground.wordpress.net/...
  Link expires ... and is single-use limited.
  Opening in your default browser ...
Upgrade to Pro/Agency or buy PAYG credits, then re-run convert to download theme.zip.

Paid conversions (PRO/Agency/PAYG) download theme.zip automatically and print the preview URL without auto-opening unless you pass --open.

Quickstart (CLI)

Current release: [email protected]

npm install -g wpconvert
# or: npx wpconvert
wpconvert convert .         # no key: offers free guest previews after a browser check
wpconvert login             # or sign in through your browser (saves a key)
wpconvert quota
wpconvert convert . --type theme
wpconvert plans             # what each option includes and costs
wpconvert unlock <jobId>    # buy this theme or a plan, then download it

The CLI smart-zips your folder, runs a capability preflight before upload, polls until done, then downloads theme.zip (paid) or opens a Playground preview (free preview-only).

Useful `convert` flags

wpconvert convert . --dry-run      # list what would upload; no upload, no credit
wpconvert convert . --no-download    # paid: skip auto-download on success
wpconvert convert . --open           # paid: auto-open Playground in browser
wpconvert convert . --no-open        # preview-only: don't auto-open browser (CI/headless)
wpconvert convert . --no-preview     # skip Playground preview entirely
wpconvert preview <jobId> --open     # open an existing job's preview later

Preview before uploading

wpconvert convert . --dry-run

--dry-run lists exactly what would be uploaded — no upload, no credit used.

Safety defaults

By default the CLI excludes:

.env and secret files (*.pem, *.key, id_rsa*, .npmrc, .ssh/, credentials*.json, …)
node_modules, .git, build output (dist/, build/, …)
Your project's .gitignore patterns

Symlinks are never followed. Use --include-env only if you truly intend to upload secrets (not recommended).

Only upload projects you own or have permission to process through WPConvert.

Developer API (REST)

WPConvert offers three developer surfaces: REST API, CLI, and MCP. All call the same hosted API at https://api.wpconvert.ai.

Surface	Entry point
OpenAPI 3.1	`openapi.yaml` — canonical machine-readable contract (mirrored from production)
REST guide	`docs/api.md` — workflows, capabilities, idempotency, status, download, Playground
CLI	`docs/cli.md` — `wpconvert quota`, `wpconvert convert ./site`
MCP	`docs/mcp.md` — six MCP tools for Cursor, Claude Desktop, etc.
Agents	`docs/agents.md` — capability gate, idempotency, preview vs download

openapi.yaml is a byte-identical mirror of the canonical WPConvert API contract maintained in the private application repository. Do not independently modify API behavior or schemas here. Contract changes originate with the production API and are mirrored into this repository.

Quick example:

curl https://api.wpconvert.ai/api/convert/quota \
  -H "X-API-Key: wpc_live_EXAMPLE_ONLY_NOT_A_REAL_KEY"

See docs/api.md for the full workflow (quota → convert → status → download or Playground) and examples/ for end-to-end scripts.

API overview (legacy quick reference)

Prefer docs/api.md and openapi.yaml for the current contract. The table below is a minimal quick reference.

All requests require the X-API-Key header. Base URL: https://api.wpconvert.ai

Method	Endpoint	Purpose
`GET`	`/api/convert/quota`	Preflight quota and developer capabilities
`POST`	`/api/convert`	Upload a zip and start conversion (multipart)
`POST`	`/api/convert/upload-url`	Mint a signed URL for large archives
`POST`	`/api/convert/from-storage`	Queue conversion after signed upload
`GET`	`/api/convert/{jobId}/status`	Poll conversion status
`GET`	`/api/download/{projectId}`	Get download URL for a completed conversion
`POST`	`/api/playground/sessions`	Create a Playground preview session

Start a conversion

curl -X POST https://api.wpconvert.ai/api/convert \
  -H "X-API-Key: wpc_live_EXAMPLE_ONLY_NOT_A_REAL_KEY" \
  -F "[email protected]" \
  -F "project_name=my-site" \
  -F "export_type=theme"

Returns { "jobId": "...", "status": "queued", ... }.

Check status

curl https://api.wpconvert.ai/api/convert/JOB_ID/status \
  -H "X-API-Key: wpc_live_EXAMPLE_ONLY_NOT_A_REAL_KEY"

Download result

curl https://api.wpconvert.ai/api/download/PROJECT_ID \
  -H "X-API-Key: wpc_live_EXAMPLE_ONLY_NOT_A_REAL_KEY"

Returns { "download_url": "https://...", "name": "my-site-theme.zip" }. Follow the download_url to fetch the theme zip — do not hard-code storage paths.

See docs/api.md, openapi.yaml, and examples/ for full examples.

Environment variables

Variable	Purpose
`WPCONVERT_API_KEY`	API key (overrides stored config)
`WPCONVERT_API_BASE`	Override API base URL (advanced/testing)

See .env.example for a safe template with fake values.

Development

git clone https://github.com/FTWAgency/wpconvert-devtools.git
cd wpconvert-devtools
npm install
npm run check

WPConvert MCP

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install WPConvert MCP?

Does WPConvert MCP need an API key?

What transport does WPConvert MCP use?

When was WPConvert MCP last checked?

Documentation

WPConvert Devtools

Agent quickstart (MCP)

MCP setup (Cursor / Claude Code / Claude Desktop)

What this repo is NOT

Requirements

Free developer previews

Expected preview-only CLI output

Quickstart (CLI)

Useful `convert` flags

Preview before uploading

Safety defaults

Developer API (REST)

API overview (legacy quick reference)

Start a conversion

Check status

Download result

Environment variables

Development

License

Security

Contributing

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install WPConvert MCP?

Does WPConvert MCP need an API key?

What transport does WPConvert MCP use?

When was WPConvert MCP last checked?

Documentation

WPConvert Devtools

Agent quickstart (MCP)

MCP setup (Cursor / Claude Code / Claude Desktop)

What this repo is NOT

Requirements

Free developer previews

Expected preview-only CLI output

Quickstart (CLI)

Useful convert flags

Preview before uploading

Safety defaults

Developer API (REST)

API overview (legacy quick reference)

Start a conversion

Check status

Download result

Environment variables

Development

License

Security

Contributing

Useful `convert` flags