paperclipai/paperclip · error · ToolGatewayHttpError

local_stdio_command_unavailable

local_stdio_command_unavailable

Error message

Local stdio template does not define an executable command

What it means

Pre-launch sanity check in callLocalStdioMcp: the resolved runtime template has no command executable defined, so there is nothing to spawn. Returned as 501 (not implemented) because the template configuration itself is incomplete — fix the template definition rather than retrying the call.

Solutions

1. Define an executable command in the local stdio template configuration.

When it happens

Trigger: Thrown at server/src/services/tool-gateway.ts:2640 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@3f1d897a7c (2026-08-18). Data as JSON: /api/errors/f8252a3b680496c0. Report an issue: GitHub.

Appendix: source

Thrown at server/src/services/tool-gateway.ts:3438

        summary.collisionRules.push({
          header: name,
          source: "credential",
          action: "overrode_previous_header",
        });
      }
      headers[name] = value;
    }

    summary.staticHeaderNames.sort();
    summary.passthroughHeaderNames.sort();
    summary.droppedPassthroughHeaderNames = [
      ...new Set(summary.droppedPassthroughHeaderNames),
    ].sort();
    summary.metadataHeaderNames.sort();
    return { headers, summary };
  }

  async function markRemoteConnectionHealth(
    connection: typeof toolConnections.$inferSelect,
    status: "ok" | "error" | "missing_secret" | "degraded",
    message: string | null,
  ) {
    const now = new Date();
    await db
      .update(toolConnections)
      .set({
        healthStatus: status,
        healthMessage: message,
        healthCheckedAt: now,
        lastHealthAt: now,
        lastError: status === "ok" ? null : message,
        updatedAt: now,
      })
      .where(eq(toolConnections.id, connection.id));
  }

View on GitHub (pinned to 3f1d897a7c)