paperclipai/paperclip · error · ToolGatewayHttpError

elicitation_not_supported

elicitation_not_supported

Error message

MCP elicitation is not supported for non-interactive gateway clients

What it means

An upstream MCP server sent an elicitation request, but the gateway client is non-interactive and the session has no issue thread to surface an ask on. The 409 fires in requestElicitationForRecordedToolCall because gateway tool calls cannot block on interactive input; the call must be deferred to an elicitation/approval interaction instead.

Source

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

  function credentialVersionRefHash(value: Record<string, unknown>): string {
    return stableHash(value);
  }

  async function resolveConnectedCredentialVersion(
    connection: typeof toolConnections.$inferSelect,
    input: {
      secretId: string;
      versionSelector: SecretVersionSelector | undefined;
      configPath: string;
      refHash: string;
      requireResolved: boolean;
    },
  ): Promise<ConnectedCredentialVersionSnapshot> {
    const versionSelector = input.versionSelector ?? "latest";
    try {
      const resolvedVersion = await secrets.resolveSecretVersion(connection.companyId, input.secretId, versionSelector);
      return {
        refHash: input.refHash,
        versionSelector: String(versionSelector),
        resolvedVersion,
      };
    } catch {
      await markRemoteConnectionHealth(connection, "missing_secret", "A configured credential secret could not be resolved.");
      if (input.requireResolved) {
        throw new ToolGatewayHttpError(
          422,
          "A configured credential secret could not be resolved.",
          "mcp_remote_missing_secret",
          { connectionId: connection.id, credential: input.configPath },
        );
      }
      return {
        refHash: input.refHash,
        versionSelector: String(versionSelector),
        resolvedVersion: -1,
      };

View on GitHub (pinned to 01ad858492)

Solutions

1. This gateway client is non-interactive and cannot answer elicitation prompts. Use an interactive client or pre-supply the required input.

When it happens

Trigger: Thrown at server/src/services/tool-gateway.ts:2942 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/33b54c50947c6d34. Report an issue: GitHub.