# WPConvert MCP (npm · @wpconvert/mcp)

Convert frontend folders to WordPress themes: quota, convert, status, download, preview, failures.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-20

## Components

- npm · `@wpconvert/mcp`: 65/100 (this document), [markdown](https://verifymcp.io/servers/ai-wpconvert-mcp/wpconvert-mcp.md), [page](https://verifymcp.io/servers/ai-wpconvert-mcp/wpconvert-mcp)

## Channel facts

- Registry: `npm`
- Package: `@wpconvert/mcp`
- Version: `0.3.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-20.

- **Supply Chain Security**: 89/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects adm-zip 0.5.18, reached via wpconvert > adm-zip. A fixed version is available.
  - No install/post-install scripts declared.
  - 30 of 98 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 74/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 712 tokens (~118/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 88/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 64% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add ai-wpconvert-mcp -- npx -y @wpconvert/mcp
```

### Codex

```bash
codex mcp add ai-wpconvert-mcp -- npx -y @wpconvert/mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-wpconvert-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@wpconvert/mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ai-wpconvert-mcp --command npx --arg -y --arg @wpconvert/mcp
```

### Hermes

```yaml
mcp_servers:
  ai-wpconvert-mcp:
    command: "npx"
    args: ["-y", "@wpconvert/mcp"]
```

### Other

```json
{
  "mcpServers": {
    "ai-wpconvert-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wpconvert/mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-19 (score 65)

First indexed and scored.

## MCP tools (6)

### `wpconvert_convert_folder` (~308 tokens)

Zip a local folder (excluding node_modules, build output, and secrets by default) and start a WordPress theme conversion. Call wpconvert_quota first to review capabilities (mode, credits, download availability). Returns a jobId and an idempotency_key. Leave idempotency_key blank for a new intentional conversion. If a prior call may have timed out or returned an ambiguous network error, retry with the exact idempotency_key returned by that prior call — do not omit it and do not invent a new one. Do not reuse a key for changed files, options, or a deliberate new conversion. Once you have a jobId, poll wpconvert_check_status until "done", then follow recommended_next for download or preview.

Input parameters:

- `idempotency_key` (string): Leave blank for a new intentional conversion. If a prior call may have timed out or returned an ambiguous network error, retry with the exact idempotency_key returned by that prior call. Do not reuse…
- `includeEnv` (boolean): DANGER: include .env / secret files (default false).
- `maxAssetSizeMB` (number): Exclude individual files larger than this many MB.
- `name` (string): Project name (defaults to folder name).
- `path` (string, required): Absolute or relative path to the folder to convert.
- `type` (string): Export type. Only "theme" is supported right now.

### `wpconvert_check_status` (~123 tokens)

Check the status of a conversion job. Returns persisted status per the OpenAPI ConversionStatus enum (queued, analyzing, building, rendering, labeling, generating, validating, uploading, done, failed). The tool-layer bucket `processing` means still in progress — it is not a persisted API value. Also returns progress, download/preview availability, and recommended_next (which tool to call next). When done and downloadable, recommended_next points to wpconvert_download_result; for preview-only jobs it points to wpconvert_create_preview instead.

Input parameters:

- `jobId` (string, required)

### `wpconvert_download_result` (~85 tokens)

Download a completed conversion to disk. Only use when wpconvert_check_status shows download_available and recommended_next is wpconvert_download_result. Returns the saved file path. For preview-only jobs, use wpconvert_create_preview or upgrade and re-convert instead.

Input parameters:

- `jobId` (string, required)
- `outDir` (string): Directory to save into (default: current directory).

### `wpconvert_create_preview` (~90 tokens)

Create a WordPress Playground preview link for a completed conversion so the user can view the theme running in a live, in-browser WordPress (no local install). Returns a URL the user must open in a browser — you cannot embed or render it yourself. The link expires after about ten minutes and grants temporary access to the theme, so treat it as sensitive.

Input parameters:

- `jobId` (string, required)

### `wpconvert_explain_failure` (~61 tokens)

Return the failure reason for a failed conversion job. Distinguishes status retries, recovering a submission with the same idempotency_key via wpconvert_convert_folder, and starting a deliberate new conversion without that key.

Input parameters:

- `jobId` (string, required)

### `wpconvert_quota` (~45 tokens)

Show account quota, capabilities (conversion mode, can_start, download availability), and recommended_next. Call this before wpconvert_convert_folder to understand what the next conversion will consume.

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/ai-wpconvert-mcp/wpconvert-mcp#diagnostics

## Score history

- 2026-08-20: 65
- 2026-08-19: 65

## Links

- npm package: https://www.npmjs.com/package/@wpconvert/mcp
- Socket report: https://socket.dev/npm/package/@wpconvert/mcp
- Repository: https://github.com/FTWAgency/wpconvert-devtools
- Website: https://wpconvert.ai/developers
- Changelog RSS feed: https://verifymcp.io/servers/ai-wpconvert-mcp/wpconvert-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/ai-wpconvert-mcp/wpconvert-mcp.json
- HTML version of this page: https://verifymcp.io/servers/ai-wpconvert-mcp/wpconvert-mcp