Environment variables

The proxy reads its configuration entirely from environment variables, typically set in the env block of your MCP client config (see Connect your agent).

Variable	Required	Default	Description
UIGRAPH_MCP_SERVER_URL	Yes	—	Base URL of the UIGraph MCP server the proxy forwards requests to. Use your organization's server URL — https://mcp.uigraph.app for UIGraph Cloud, or your own deployment's URL when self-hosting. The proxy exits if this is not set.
UIGRAPH_ACCESS_TOKEN	No	—	A service-account token (uig_…) for non-interactive authentication. This is for service accounts only — it is not for user accounts, which authenticate interactively through auth login. When set, it takes precedence over any credentials in the keychain, so the proxy never needs an interactive login. Intended for CI and automation.
UIGRAPH_ORG_ID	No	—	The organization id used as the default for MCP tool calls, for accounts that belong to multiple organizations. A default org set via auth default-org takes precedence over this variable; if neither is set, the first organization on your account is used. See Organizations.