paperclipai/paperclip · error · ToolGatewayHttpError

remote_mcp_error

remote_mcp_error

Error message

Remote MCP server returned an error

What it means

Remote MCP forwarding failure wrapper: the upstream request failed at the transport/execution level (network error, malformed response, or other non-HTTP-error failure). The 502 mcp_remote_failed surfaces the underlying problem with execution details so callers can distinguish upstream failure from policy denial.

Source

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

    };
    const [existing] = await db.select({ id: issueThreadInteractions.id }).from(issueThreadInteractions).where(and(
      eq(issueThreadInteractions.companyId, session.companyId),
      eq(issueThreadInteractions.issueId, session.issueId),
      eq(issueThreadInteractions.idempotencyKey, idempotencyKey),
    )).limit(1);
    if (existing) {
      await db.update(issueThreadInteractions).set({
        status: "pending",
        continuationPolicy: "wake_assignee",
        requestedResolverPolicy: "human_only",
        effectiveResolverPolicy: "human_only",
        resolverPolicyProvenance: "explicit",
        effectiveResolverPolicySource: "requested",
        addresseeUserId: userId,
        payload,
        result: null,
        resolvedAt: null,
        updatedAt: new Date(),
      }).where(eq(issueThreadInteractions.id, existing.id));
      return;
    }
    await db.insert(issueThreadInteractions).values({
      companyId: session.companyId,
      issueId: session.issueId,
      kind: "request_confirmation",
      status: "pending",
      continuationPolicy: "wake_assignee",
      requestedResolverPolicy: "human_only",
      effectiveResolverPolicy: "human_only",
      resolverPolicyProvenance: "explicit",
      effectiveResolverPolicySource: "requested",
      idempotencyKey,
      sourceRunId: session.runId,
      title: `Delegate your ${connection.name}`,
      summary: "An explicit standing delegation is required for this autonomous run.",
      createdByAgentId: session.agentId,

View on GitHub (pinned to 5716fe907e)

Solutions

1. The remote MCP server returned a protocol error. Inspect the error code/message and fix the request or the remote server.

When it happens

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

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@5716fe907e (2026-08-18). Data as JSON: /api/errors/51788fee59673698. Report an issue: GitHub.