@wavespeed/mcp 1.0.9 → 1.0.11

package/README.md

@@ -43,6 +43,30 @@ Some generations take minutes to hours. `run_model` waits up to `wait_seconds` (
 
 ## Setup
 
+### Remote (nothing to install)
+
+The same server is hosted at:
+
+```text
+https://api.wavespeed.ai/mcp
+```
+
+- **Claude on the web / ChatGPT:** add a custom connector with that address and approve the connection on the WaveSpeed page that opens. Approving creates a dedicated API key (named `MCP · <app>`) that you can delete on the [API Keys](https://wavespeed.ai/accesskey) page to disconnect.
+- **Claude Code:** `claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp`
+- **Cursor:**
+  <a href="https://cursor.com/install-mcp?name=wavespeed&config=eyJ1cmwiOiJodHRwczovL2FwaS53YXZlc3BlZWQuYWkvbWNwIn0%3D">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/deeplink/mcp-install-light.svg">
+      <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add the hosted wavespeed MCP server to Cursor" height="32"/>
+    </picture>
+  </a>
+- **VS Code:** `code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}'`
+- **Any other client that sends request headers:** point it at the URL with `Authorization: Bearer <your API key>`.
+
+The hosted server has the same tools except for files: it cannot read files on your computer, so pass public URLs, or use `create_upload` from a tool that can send HTTP requests (it returns a temporary upload address and the `download_url` to use as an input). Full guide: [wavespeed.ai/docs/mcp](https://wavespeed.ai/docs/mcp).
+
+### Local (npx)
+
 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**

package/dist/lib/api.js

@@ -77,9 +77,12 @@ function authHeaders() {
     }
     return { Authorization: `Bearer ${apiKey}`, ...clientAttributionHeaders() };
 }
-// A hung socket would otherwise stall the tool call until the client gives
-// up. 30s is far above a healthy read, so it only trips on a dead connection.
-const GET_TIMEOUT_MS = 30_000;
+// Per-request timeouts (no overall cap). A hung socket would otherwise stall
+// the tool call. Read-only GETs are far below 30s in practice (result p99.9
+// < 1s); the async submit gets more headroom because a timeout there is an
+// ambiguous outcome, not a clean failure.
+export const GET_TIMEOUT_MS = 30_000;
+export const SUBMIT_TIMEOUT_MS = 60_000;
 async function apiGetOnce(apiPath) {
     const res = await fetch(`${getBaseUrl()}${apiPath}`, {
         headers: authHeaders(),
@@ -119,11 +122,12 @@ async function apiGet(apiPath, opts = {}) {
         }
     }
 }
-async function apiPost(apiPath, body) {
+async function apiPost(apiPath, body, opts = {}) {
     const res = await fetch(`${getBaseUrl()}${apiPath}`, {
         method: 'POST',
         headers: { ...authHeaders(), 'Content-Type': 'application/json' },
         body: JSON.stringify(body),
+        signal: opts.timeoutMs ? AbortSignal.timeout(opts.timeoutMs) : undefined,
     });
     if (!res.ok)
         throw await httpError(res, 'POST', apiPath);
@@ -168,7 +172,16 @@ export async function fetchPricing(modelId, inputs) {
  * mid-generation must never orphan a paid task.
  */
 export async function submitPrediction(model, input) {
-    return apiPost(`/api/v3/${model}`, { ...input });
+    try {
+        return await apiPost(`/api/v3/${model}`, { ...input }, { timeoutMs: SUBMIT_TIMEOUT_MS });
+    }
+    catch (err) {
+        // Never retried: the server may already have created (and billed) the task.
+        if (err?.name === 'TimeoutError') {
+            throw new Error(`Submission outcome unknown: no response within ${SUBMIT_TIMEOUT_MS / 1000}s. The task may have been created and billed — do not resubmit blindly; if you have a prediction id, check it with get_prediction.`);
+        }
+        throw err;
+    }
 }
 // The message always carries the task id and says the task was not declared
 // failed — a status read that dies after submit must not look like a lost

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavespeed/mcp",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "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": {
@@ -39,7 +39,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "wavespeed": "^0.3.2",
+    "wavespeed": "^0.3.4",
     "zod": "^3.24.0"
   },
   "devDependencies": {