Documentation

Authentication and scoped grants

Management requests use X-Admin-Key: <wgk_...>. Store the value in an OS keychain or environment variable and pass only its reference to MCP configuration. Never commit a literal key.

weirgate auth login opens https://dashboard.weirgate.com/consent by default. The signed-in developer reviews tenant, apps, tool groups, scope, environment, and expiry; the CLI exchanges the resulting single-use localhost callback code and stores the reveal-once bounded key in macOS Keychain. Propose is the default. Apply consent requires a recent Clerk second factor. --stdin remains available for an already-minted key.

Scopes are hierarchical: read < propose < apply. Resource bounds are independent: app_ids, tool_groups, and environment further constrain the key. A propose key can create and cancel its own pending proposals, but applying a proposal or creating a grant requires apply scope. Cross-tenant and out-of-bound app reads return resource_not_found.

The platform super-admin credential is for founder operations only. It is not accepted by the MCP server or CLI authentication workflow.

GET /v1/admin/auth-presets returns non-secret templates for Firebase, Supabase, Clerk, and custom public OIDC/JWKS issuers. Standards-based configs use mode: jwks with an HTTPS issuer, public HTTPS JWKS URL, optional audience, and an external-ID claim that defaults to sub. Service-role secrets are never accepted.

Weirgate API 2026-07-18