paperclipai/paperclip · error · ToolGatewayHttpError

local_stdio_connection_disabled

local_stdio_connection_disabled

Error message

Connection is disabled.

What it means

Local stdio MCP connection guard: the catalog entry resolved to a connection whose transport is not local_stdio (or that is disabled/inactive), so local stdio dispatch is refused. Indicates the tool's connection type changed or the connection was disabled, and the agent should not keep retrying the call.

Source

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

    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));
  }

  function grantRefForCredential(
    grant: typeof connectionGrants.$inferSelect,
    ref: McpConnectionCredentialRef,
  ): ToolCredentialSecretRef | undefined {
    return grant.credentialSecretRefs.find((candidate) =>
      candidate.configPath === ref.name || candidate.configPath === `credentials.${ref.name}`,
    );
  }

  async function resolveGrantSecretValue(
    session: ToolGatewaySession,
    connection: typeof toolConnections.$inferSelect,
    grant: typeof connectionGrants.$inferSelect,
    ref: ToolCredentialSecretRef,
    configPath = ref.configPath,
  ): Promise<string> {
    const accessContext = {
      consumerType: "tool_connection" as const,
      consumerId: connection.id,
      configPath,
      actorType: "system" as const,

View on GitHub (pinned to 01ad858492)

Solutions

1. Enable the connection in connection settings before invoking its tools.

When it happens

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

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/576ec99b794a86ab. Report an issue: GitHub.