# WPConvert MCP

> WPConvert MCP is a freemium MCP server for developer tools. Converts local websites or AI-built sites into WordPress themes from an agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://wpconvert.ai/developers
- **Repository:** https://github.com/ftwagency/wpconvert-devtools/tree/HEAD/packages/mcp
- **MCP Registry name:** ai.wpconvert/mcp
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-14

## About

The agent works on a folder rather than an uploaded file. wpconvert_convert_folder zips the workspace, leaving out node_modules, build output and secrets, then starts a conversion and returns a job id that the agent polls with wpconvert_check_status. A finished theme is downloaded with wpconvert_download_result, or previewed through a WordPress Playground link that expires in about ten minutes.

The README recommends calling wpconvert_quota first to learn what is possible. Access works in tiers: no key is needed to start, because the agent can offer a link for a few free guest previews after a quick human check in the browser. Downloads need Starter, Pro, Agency or pay-as-you-go credits, and wpconvert_checkout returns a Stripe link that you open and pay yourself.

Run it locally with npx @wpconvert/mcp (Node 18+) or connect to the hosted endpoint. It wraps the same API as the wpconvert CLI.

## Features

- **Folder conversion:** Zips a project folder and starts a WordPress theme conversion.
- **Live preview:** Creates a short-lived WordPress Playground link.
- **Guest previews:** Gives free previews without an account.
- **Quota guidance:** Reports capabilities and recommended next steps.
- **Checkout links:** Returns a Stripe link; the agent never pays.

## Good for

- Turn an AI-built site into a WordPress theme
- Preview a converted theme before buying
- Convert a Cursor or Claude project folder
- Find out why a conversion failed

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.wpconvert.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.wpconvert.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.wpconvert.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.wpconvert.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.wpconvert.ai/mcp"
    }
  }
}
```

## Tools

- `wpconvert_convert_folder`: Zips a folder and starts a conversion.
- `wpconvert_check_status`: Polls a job's status.
- `wpconvert_download_result`: Downloads a completed conversion.
- `wpconvert_create_preview`: Gets a WordPress Playground preview URL.
- `wpconvert_explain_failure`: Returns the failure reason for a failed job.
- `wpconvert_quota`: Shows quota, capabilities and recommended next step.
- `wpconvert_connect`: Starts a guest or sign-in browser link.
- `wpconvert_connect_status`: Checks whether the link was completed.
- `wpconvert_plans`: Lists options with today's price.
- `wpconvert_checkout`: Returns a Stripe checkout link.

## FAQ

### Do I need an API key?

No. Without one the agent offers a guest link or a sign-in link.

### Can I download without paying?

Downloads need Starter, Pro, Agency or pay-as-you-go credits.

### What is excluded from the zip?

node_modules, build output and secrets.

### How long does a preview link last?

About ten minutes.

### Is WPConvert MCP free?

WPConvert MCP has a free plan, with paid plans for more usage or features.

### How do I add WPConvert MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.wpconvert.ai/mcp

### What are the best alternatives to WPConvert MCP?

The closest alternatives to WPConvert MCP are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/wpconvert-mcp
