@wpconvert/mcp
Advanced tools
+21
| 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). |
+6
-4
@@ -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 @@ ); |
No bug tracker
MaintenancePackage does not have a linked bug tracker in package.json.
No repository
Supply chain riskPackage does not have a linked source code repository. Without this field, a package will have no reference to the location of the source code use to generate the package.
No website
QualityPackage does not have a website.
40766
4.06%5
25%823
0.12%0
-100%1
-50%4
-20%84
-2.33%+ Added
- Removed
Updated