Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoPort the production server listens on. Defaults to 8080.8080
NODE_ENVNoWhen set to production, the development AGORA_MCP_TOKEN is ignored unless AGORA_ALLOW_DEV_TOKEN=1.
AWS_REGIONNoAWS region used by Amazon Bedrock when AGORA_SERVER_LLM=bedrock.
EXA_API_KEYNoWhen set, enables the web_research MCP tool.
QLOO_API_KEYNoAPI key read by the qloo mcp child process from QLOO_API_KEY or the harness's own config. Never logged or returned by the server.
VERTEX_MODELNoOverride the default Vertex AI model.google/gemini-3.8-flash
BEDROCK_MODELNoOverride the default Bedrock model.anthropic.claude-sonnet-5
AGORA_DATA_DIRNoDirectory for household files. OAuth refresh records are stored as oauth-refreshes.json in this directory..agora-data
AGORA_TIMEZONENoCalendar day used for 'due today' and reminder times. Unset uses the server's timezone.
AGORA_DEMO_SEEDNoSet to 1 to write the fictional demo family into empty memory at startup.
AGORA_MCP_TOKENNoDevelopment bearer token for Claude Code and the Inspector. Must be at least 32 characters; shorter values are ignored. Ignored in production or behind an https public URL unless AGORA_ALLOW_DEV_TOKEN=1.
ALEXA_SIM_MODELNoOverride the model used for spoken turns, for example google/gemini-3.8-flash.
AGORA_PUBLIC_URLNoPublic HTTPS origin, no path. Required before OAuth or /mcp will answer on a process that is not bound to loopback.
AGORA_SERVER_LLMNoServer model provider used when the browser sent no key: vertex, bedrock, or openai.
DEMO_HOST_SECRETNoRoom host code. On an open bind with no passcode, the office has no first-caller host.
AGORA_TRUST_PROXYNoSet to 1 before X-Forwarded-Proto affects the Secure cookie or the OAuth issuer.
FIRECRAWL_API_KEYNoWhen set, enables the web_research MCP tool.
VERTEX_FAST_MODELNoOverride the default fast Vertex AI model used for spoken turns.google/gemini-3.5-flash-lite
AGORA_TOKEN_SECRETNoHMAC secret for OAuth access and refresh tokens. OAuth stays off when it is shorter than 32 characters.
BEDROCK_FAST_MODELNoOverride the default fast Bedrock model used for spoken turns.anthropic.claude-haiku-4-5
AGORA_QLOO_IN_FLIGHTNoNumber of concurrent Qloo calls, from 1 to 4. Default is 1.1
AGORA_TASTE_LOCATIONNoDefault location for the Taste Council. Enables age-band signals and filters places.
GOOGLE_CLOUD_PROJECTNoGoogle Cloud project for Vertex AI when AGORA_SERVER_LLM=vertex. Must be supplied from the shell because npm run dev only copies named settings from .env.
AGORA_ALLOW_DEV_TOKENNoSet to 1 to keep the development token usable when NODE_ENV=production or AGORA_PUBLIC_URL is https.
AGORA_OAUTH_CLIENT_IDNoOAuth client id.
AGORA_HOUSEHOLD_PASSCODENoWhen set, household HTTP routes need the agora_household cookie. Production listens on 0.0.0.0 only when this is set. Five wrong guesses, then 15 minutes and HTTP 429.
AGORA_OAUTH_CLIENT_SECRETNoOAuth client secret. Accepts HTTP Basic or the form body, never both.
AGORA_OAUTH_REDIRECT_URISNoComma-separated exact redirect_uri values. The simulator's own http://127.0.0.1, http://localhost, and ::1 callbacks are always allowed.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

NameDescription

No tools

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Maintenance

ActivityActive
ResponsivenessNo issues