Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OAUTH_ISSUERYesYour OAuth 2.1 authorization server
CORTEX_BACKENDSYesComma-separated list of backend IDs
CORTEX_DATABASE_URLNoPostgreSQL for audit persistence + gateway tickets
CORTEX_CANONICAL_URINoCanonical MCP resource URI (RFC 9728), default JWT audience
CORTEX_ALLOWED_ORIGINSNoWeb origins allowed (exact or *.suffix)
CORTEX_TECHNICAL_TOKENYesStatic token for catalog discovery
CORTEX_DEV_BYPASS_TOKENNoDev bypass token for local development
CORTEX_DEV_BYPASS_SCOPESNoScopes for dev bypass token
CORTEX_TICKET_WEBHOOK_URLNoWebhook for blocking missing-capability tickets

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
whoamiA

Returns the caller's OAuth identity (email, sub, pool, scopes, client, audience, jti) and aggregates the whoami of every healthy federated backend (effective role in that backend, derived capabilities). Useful to know who you are and what you may do before invoking a write tool.

list_cortex_resourcesA

Lists the MCP resources exposed by the gateway (self-describing architecture document, dynamic backend resources through URI templates). Wrapper tool over the resources/list channel, needed because some MCP clients do not surface the resources primitive in their visible tool palette.

read_cortex_resourceA

Reads an MCP resource by URI (e.g. cortex://architecture, docs://document/42). Wrapper tool over the resources/read channel. Returns Markdown or JSON depending on the resource. Use after list_cortex_resources to discover available URIs.

report_missing_capabilityA

Reports a missing capability or an insufficient tool to the platform team. Use it when you cannot fulfil a user request because no MCP tool offers what is needed, OR when an existing tool limits you (incomplete return, missing parameter, unhelpful error, ...).

Typical example: the user asks for a link to a file; you search the returns of list_files / read_file, there is no webUrl field; you report the missing capability. The platform team prioritizes and ships the field in a next release.

Principle: your ticket is a SIGNAL, not an implementation order. Several converging tickets = a priority. Do not hesitate to report even when unsure — noise is filtered at triage. Do NOT report an obvious bug (the API returns 500) — let the error surface naturally instead.

Auto-dedup: an identical ticket (same description + same tool + same agent) within 24h just refreshes the timestamp instead of creating a duplicate.

Before reporting, consider calling list_cortex_tickets to check you have not already filed a similar ticket — avoids re-filing in a loop.

Returns: { ticketId, deduplicated, ackMessage }.

list_cortex_ticketsA

Lists your own previously filed report_missing_capability tickets (auto-filtered by OAuth identity — you do not see other agents' tickets). Useful before re-filing a ticket, or to follow a ticket's status after triage by the platform team.

Possible statuses: open (just filed), triaged (the team looked at it), planned (work scheduled), resolved (capability shipped, resolvedPrUrl points at the PR), wont_fix (deliberately not implemented, triageNote explains why), duplicate (merged with another).

Returns: { tickets: [{ id, status, severity, contextTool, contextApp, whatIWanted, suggestedShape, triageNote, resolvedPrUrl, createdAt, updatedAt }] }, sorted by createdAt desc, max 100.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Gateway architectureSelf-generated description of the gateway: OAuth chain, federation model, live-discovered backends, principles.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wellknownmcp/cortex-gateway'

If you have feedback or need assistance with the MCP directory API, please join our Discord server