paperclipai/paperclip · error · PaperclipApiError

failed with

Error message

${method} ${path} failed with ${status}: ${body.error}

What it means

Error "${method} ${path} failed with ${status}: ${body.error}" thrown in paperclipai/paperclip.

Solutions

1. Inspect the returned error body for the cause, fix the request (auth, ids, payload), and retry.
2. Verify PAPERCLIP_API_URL and PAPERCLIP_API_KEY are correct for the target company.

When it happens

Trigger: Thrown at packages/mcp-server/src/client.ts:103 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@120ae5428f (2026-08-18). Data as JSON: /api/errors/16c785206cdac591. Report an issue: GitHub.

Appendix: source

Thrown at packages/mcp-server/src/client.ts:103

      Authorization: `Bearer ${this.config.apiKey}`,
      Accept: "application/json",
    };
    if (options.body !== undefined) {
      headers["Content-Type"] = "application/json";
    }
    if ((options.includeRunId ?? isWriteMethod(method)) && this.config.runId) {
      headers["X-Paperclip-Run-Id"] = this.config.runId;
    }

    const response = await fetch(url, {
      method,
      headers,
      body: options.body === undefined ? undefined : JSON.stringify(options.body),
    });
    const parsedBody = await parseResponseBody(response);

    if (!response.ok) {
      throw new PaperclipApiError({
        status: response.status,
        method: method.toUpperCase(),
        path,
        body: parsedBody,
        message: buildErrorMessage(method.toUpperCase(), path, response.status, parsedBody),
      });
    }

    return parsedBody as T;
  }
}

View on GitHub (pinned to 120ae5428f)