Sign In

@wpconvert/mcp

Package Overview
Dependencies
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@wpconvert/mcp - npm Package Compare versions

Comparing version
0.3.0
to
0.3.1
+21
LICENSE
MIT License
Copyright (c) 2026 WPConvert.ai
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
+26
-5
{
"name": "@wpconvert/mcp",
"version": "0.3.0",
"version": "0.3.1",
"description": "Model Context Protocol server for WPConvert.ai — lets an AI agent convert the current workspace folder into a WordPress theme.",
"license": "MIT",
"author": "WPConvert.ai",
"homepage": "https://wpconvert.ai/developers",
"bugs": {
"url": "https://github.com/FTWAgency/wpconvert-devtools/issues"
},
"repository": {
"type": "git",
"url": "git+https://github.com/FTWAgency/wpconvert-devtools.git",
"directory": "packages/mcp"
},
"mcpName": "ai.wpconvert/mcp",
"type": "module",

@@ -13,3 +23,4 @@ "bin": {

"src/",
"README.md"
"README.md",
"LICENSE"
],

@@ -21,3 +32,3 @@ "engines": {

"start": "node src/server.mjs",
"test": "node --test tests/**/*.test.js"
"test": "node scripts/run-tests.cjs"
},

@@ -29,3 +40,3 @@ "publishConfig": {

"@modelcontextprotocol/sdk": "^1.0.0",
"wpconvert": "0.3.0"
"wpconvert": "0.3.1"
},

@@ -37,4 +48,14 @@ "keywords": [

"wpconvert",
"ai"
"ai",
"lovable",
"cursor",
"v0",
"vite",
"react",
"frontend",
"static-site",
"ai-agent",
"agent",
"llm"
]
}
+4
-6

@@ -14,5 +14,5 @@ # @wpconvert/mcp

| `wpconvert_convert_folder` | Zip a folder (excluding `node_modules`, build output, secrets) and start a conversion. Returns a `jobId`. |
| `wpconvert_check_status` | Poll a job's status (`queued` / `processing` / `done` / `failed`). |
| `wpconvert_check_status` | Poll a job's status. Persisted values follow the OpenAPI `ConversionStatus` enum (`queued`, pipeline stages, `done`, `failed`). The tool-layer bucket `processing` means still in progress — not a persisted API value. |
| `wpconvert_download_result` | Download a completed conversion to disk. |
| `wpconvert_create_preview` | Get a WordPress Playground URL to view the theme in a live in-browser WordPress. The link expires (~30 min) and is sensitive — open it in a browser. |
| `wpconvert_create_preview` | Get a WordPress Playground URL to view the theme in a live in-browser WordPress. The link expires after about ten minutes and is sensitive — open it in a browser. |
| `wpconvert_explain_failure` | Return the failure reason for a failed job. |

@@ -66,3 +66,3 @@ | `wpconvert_quota` | Show quota, capabilities, and `recommended_next`. Call before converting. |

- `queued` / `processing` → `wpconvert_check_status` (poll)
- `queued`, pipeline stages, or tool-layer `processing` → `wpconvert_check_status` (poll)
- `done` + downloadable → `wpconvert_download_result`

@@ -85,4 +85,2 @@ - `done` + preview-only / download locked → `wpconvert_create_preview` (never download)

This package pins `wpconvert@0.3.0` exactly for shared capability helpers (`resolveConvertPreflight`, quota formatters). MCP package version remains **0.2.0** until a separate release review.
Billing, quotas, and refunds are identical to the dashboard and CLI for paid conversions. Free developer previews are preview-only (Playground, no ZIP download) and limited to 3 lifetime attempts per account. Secrets are excluded from the zip by default (set `includeEnv: true` only if you truly need them).
This package pins `wpconvert@0.3.0` exactly for shared capability helpers (`resolveConvertPreflight`, quota formatters).

@@ -29,4 +29,6 @@ #!/usr/bin/env node

const pkg = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
// Attribute MCP requests before loading the shared API client.
process.env.WPCONVERT_CLIENT = `mcp/${JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version}`;
process.env.WPCONVERT_CLIENT = `mcp/${pkg.version}`;

@@ -113,3 +115,3 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';

description:
'Check the status of a conversion job. Returns status (queued/processing/done/failed), 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.',
'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.',
inputSchema: {

@@ -137,3 +139,3 @@ type: 'object',

description:
'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 ~30 minutes and grants temporary access to the theme, so treat it as sensitive.',
'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.',
inputSchema: {

@@ -644,3 +646,3 @@ type: 'object',

const server = new Server(
{ name: 'wpconvert-mcp', version: '0.1.0-beta.0' },
{ name: 'wpconvert-mcp', version: pkg.version },
{ capabilities: { tools: {} } }

@@ -647,0 +649,0 @@ );