NousResearch/hermes-agent · error

OAuth server did not provide an authorization URL

Error message

OAuth server did not provide an authorization URL

What it means

Error "OAuth server did not provide an authorization URL" thrown in NousResearch/hermes-agent.

Source

Thrown at apps/desktop/src/lib/mcp-dashboard-oauth.ts:54

export async function completeMcpDesktopOAuth({
  serverName,
  start,
  status,
  openExternal,
  cancelled,
  cancel,
  sleep = defaultSleep,
  maxPollFailures = 3
}: CompleteOptions): Promise<McpOAuthFlow> {
  const started = await start(serverName)

  if (started.status === 'error') {
    throw new Error(started.error || 'OAuth failed to start')
  }

  if (!started.authorization_url) {
    throw new Error('OAuth server did not provide an authorization URL')
  }

  await openExternal(started.authorization_url)

  let pollFailures = 0

  for (;;) {
    if (cancelled?.()) {
      // Free the backend slot before rejecting; best-effort — the flow also
      // dies on its own timeout if this request is lost.
      await cancel?.(started.flow_id).catch(() => {})
      throw new McpOAuthCancelled()
    }

    let current: McpOAuthFlow

    try {
      current = await status(started.flow_id)

View on GitHub (pinned to c896c09c42)

Solutions

1. Verify the OAuth server is configured with a valid authorization endpoint.
2. Check the gateway logs for the OAuth start response and retry.
3. Re-register the MCP server OAuth client if the configuration is stale.

When it happens

Trigger: Thrown at apps/desktop/src/lib/mcp-dashboard-oauth.ts:54 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of NousResearch/hermes-agent@c896c09c42 (2026-08-14). Data as JSON: /api/errors/6c7ef43f6fcac942. Report an issue: GitHub.