@wavespeed/mcp 1.0.16 → 1.0.18

package/README.md

@@ -32,9 +32,9 @@ Built on the same design as the open-source [`@wavespeed/cli`](https://github.co
 | Tool | What it does |
 |---|---|
 | `list_models` | Search the live catalog by text or modality type |
-| `get_model_schema` | A model's real input schema (required, properties, defaults), with a link to the model's docs page |
+| `get_model_schema` | A model's real input schema (required, properties, defaults), with a link to the model's playground page |
 | `run_model` | Submit + wait; rejects input keys the model doesn't accept; `@path` inputs upload automatically; returns output URLs |
-| `get_price` | Cost estimate for the inputs you pass (no charge), with a link to the model's docs page |
+| `get_price` | Cost estimate for the inputs you pass (no charge), with a link to the model's playground page |
 | `get_balance` | Account credit balance, with the top-up link |
 | `list_predictions` | Run history (default last 24h); filter by model, status, time range |
 | `list_billings` | Itemized charges and refunds (needs a Billing-access key) |
@@ -71,12 +71,14 @@ The hosted server has the same tools, with one difference for files: it cannot r
 
 ### Local (npx)
 
+`@latest` makes npx fetch the newest release on each start; without it, npx runs a globally installed `@wavespeed/mcp` if one exists, however old.
+
 Auth resolves from `WAVESPEED_API_KEY`, or from the CLI's stored login (`wavespeed login`) — one login covers both tools. Keys: [wavespeed.ai/accesskey](https://wavespeed.ai/accesskey).
 
 **Claude Code**
 
 ```bash
-claude mcp add wavespeed -- npx -y @wavespeed/mcp
+claude mcp add wavespeed -- npx -y @wavespeed/mcp@latest
 ```
 
 **Claude Desktop / other clients** (`mcpServers` config):
@@ -86,7 +88,7 @@ claude mcp add wavespeed -- npx -y @wavespeed/mcp
   "mcpServers": {
     "wavespeed": {
       "command": "npx",
-      "args": ["-y", "@wavespeed/mcp"],
+      "args": ["-y", "@wavespeed/mcp@latest"],
       "env": { "WAVESPEED_API_KEY": "wsk_..." }
     }
   }

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// stdio entry point: `wavespeed-mcp` (or `npx -y @wavespeed/mcp`).
+// stdio entry point: `wavespeed-mcp` (or `npx -y @wavespeed/mcp@latest`).
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createServer } from './server.js';
 async function main() {

package/dist/lib/api.js

@@ -200,12 +200,9 @@ export async function fetchUsageStats(startTime, endTime, model) {
         body.model_uuid = model;
     return apiPost('/api/v3/user/usage_stats', body, { timeoutMs: GET_TIMEOUT_MS });
 }
-// The model's page on the docs site (same rule as the dashboard's model page
-// link): provider folder, then the id without a leading "wavespeed-ai/" and
-// with "/" turned into "-".
-export function modelDocsUrl(modelId) {
-    const provider = modelId.split('/')[0];
-    return `https://wavespeed.ai/docs/docs-api/${provider}/${modelId.replace('wavespeed-ai/', '').split('/').join('-')}`;
+// The model's page on the site, where it can be tried in the playground.
+export function modelPlaygroundUrl(modelId) {
+    return `https://wavespeed.ai/models/${modelId}`;
 }
 export async function fetchPricing(modelId, inputs) {
     // /model/price is the documented pricing endpoint.

package/dist/server.js

@@ -9,13 +9,13 @@
 // * Inputs are never mutated. The one explicit transform is the `@path`
 //   marker, which uploads the referenced local file and substitutes its
 //   hosted URL. Bare paths pass through untouched.
-// * Price quotes are estimates for the inputs given; the model's docs page
-//   is linked next to them for what each input means.
+// * Price quotes are estimates for the inputs given; the model's playground
+//   page is linked next to them for what each input means.
 import { createRequire } from 'node:module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { Client } from 'wavespeed';
-import { fetchModels, fetchBalance, fetchHistory, fetchBillings, fetchUsageStats, deletePredictions, PREDICTION_STATUSES, fetchPricing, modelDocsUrl, submitPrediction, waitForPrediction, MCP_CLIENT_NAME, TERMINAL_FAILURES, } from './lib/api.js';
+import { fetchModels, fetchBalance, fetchHistory, fetchBillings, fetchUsageStats, deletePredictions, PREDICTION_STATUSES, fetchPricing, modelPlaygroundUrl, submitPrediction, waitForPrediction, MCP_CLIENT_NAME, TERMINAL_FAILURES, } from './lib/api.js';
 import { getApiKey, getBaseUrl } from './lib/config.js';
 import { MAX_DELETE_IDS, prepareDelete, summarizeDelete } from './lib/delete-predictions.js';
 // Where to add credit; handed to the assistant next to the balance.
@@ -163,7 +163,7 @@ export function createServer() {
             required: schema?.required ?? [],
             properties: schema?.properties ?? {},
             property_order: schema?.['x-order-properties'] ?? [],
-            docs_url: modelDocsUrl(meta.model_id),
+            playground_url: modelPlaygroundUrl(meta.model_id),
         });
     });
     server.tool('run_model', 'Run any WaveSpeed model. input keys come from get_model_schema; unknown keys are rejected before submission. Local files: pass "@./path" string values — they are uploaded and replaced with hosted URLs (bare paths are NOT uploaded). Returns the prediction id right away (done=false); call get_prediction with that id and wait_seconds until done=true to get the output URLs. The task keeps running on the server. Pass wait_seconds here to wait for a quick model in the same call.', {
@@ -221,7 +221,7 @@ export function createServer() {
         });
         const priceInput = resolved.input;
         const data = await fetchPricing(model, priceInput);
-        return ok({ ...data, estimate: true, disclaimer: PRICE_DISCLAIMER, docs_url: modelDocsUrl(model) });
+        return ok({ ...data, estimate: true, disclaimer: PRICE_DISCLAIMER, playground_url: modelPlaygroundUrl(model) });
     });
     server.tool('get_balance', 'Show the WaveSpeed account credit balance, with the link to top up.', {}, { readOnlyHint: true, openWorldHint: true }, async () => {
         return ok({ ...(await fetchBalance()), top_up_url: TOP_UP_URL });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavespeed/mcp",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "WaveSpeed MCP server — run any model on the live WaveSpeed catalog (image, video, audio, 3D) with schema introspection, local-file upload, and price quotes.",
   "type": "module",
   "bin": {