# ── Transport ──────────────────────────────────────────────────────────
# MCP_TRANSPORT_TYPE=stdio          # stdio | http (default: stdio)
# MCP_HTTP_PORT=3010                # HTTP port (default: 3010)
# MCP_HTTP_HOST=localhost           # HTTP host (default: localhost)
# MCP_HTTP_ENDPOINT_PATH=/mcp      # HTTP endpoint path (default: /mcp)
# MCP_HTTP_MAX_BODY_BYTES=1048576  # Max request body bytes; 413 over limit, 0 disables (default: 1048576)
# MCP_PUBLIC_URL=                  # Public origin behind a TLS-terminating proxy (e.g. https://mcp.example.com)

# ── Auth ──────────────────────────────────────────────────────────────
# MCP_AUTH_MODE=none                # none | jwt | oauth (default: none)
# MCP_AUTH_SECRET_KEY=              # JWT secret (required for jwt mode)

# ── Storage ───────────────────────────────────────────────────────────
# STORAGE_PROVIDER_TYPE=in-memory   # in-memory | filesystem | supabase | cloudflare-r2 | cloudflare-kv | cloudflare-d1

# ── Session ──────────────────────────────────────────────────────────
# MCP_SESSION_MODE=stateful         # stateful | stateless (default: stateful)

# ── Memory ───────────────────────────────────────────────────────────
# MCP_GC_PRESSURE_INTERVAL_MS=0     # Opt-in forced Bun.gc(true) interval, ms (Bun only). Drains old-gen backlog
                                    # under sustained HTTP load (issue #50). Try 60000 if RSS grows. Default: 0.

# ── Logging ───────────────────────────────────────────────────────────
# MCP_LOG_LEVEL=info                # debug | info | notice | warning | error

# ── Telemetry ─────────────────────────────────────────────────────────
# OTEL_ENABLED=false                          # Enable OpenTelemetry (default: false)
# OTEL_EXPORTER_OTLP_ENDPOINT=               # OTLP endpoint URL (e.g., http://localhost:4318)

# ── MusicBrainz ──────────────────────────────────────────────────────
# MusicBrainz requires a descriptive User-Agent with a contact (email or URL) and
# rate-limits to ~1 request/second per IP. The server ships a default contact so it
# works out of the box, but operators running a shared/hosted instance should set
# their own so MusicBrainz can reach them about traffic.
# MUSICBRAINZ_CONTACT=you@example.com         # Contact in the User-Agent (default: the repo URL)
# MUSICBRAINZ_BASE_URL=https://musicbrainz.org/ws/2   # WS/2 base (override for a private mirror or beta)
# MUSICBRAINZ_RATE_LIMIT_RPS=1                 # Client-side request/sec ceiling (default: 1; lower for shared hosting)
# MUSICBRAINZ_CACHE_TTL=86400                  # Response cache TTL in seconds; 0 disables (default: 86400)
# MUSICBRAINZ_TIMEOUT_MS=30000                 # Per-request HTTP timeout in ms (default: 30000)
# MUSICBRAINZ_MAX_RETRIES=3                    # Retries for transient upstream failures (default: 3)

# ── Cover Art Archive ────────────────────────────────────────────────
# COVER_ART_BASE_URL=https://coverartarchive.org   # Cover Art Archive base URL