Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OPPEN_HOSTNoHost interface for HTTP mode. Default is 127.0.0.1.127.0.0.1
OPPEN_PORTNoLocal port for HTTP mode. Default is 8766.8766
OPPEN_STATE_DIRNoDirectory for runtime state (login token, OAuth DB, logs). Default is .runtime..runtime
OPPEN_TRANSPORTNoTransport mode. Use 'stdio' for Secure MCP Tunnel or 'http' for domain forwarding with OAuth. Defaults to 'stdio' for new installations.stdio
OPPEN_TUNNEL_IDNoTunnel ID from OpenAI Platform, required when using Secure MCP Tunnel.
OPPEN_PUBLIC_URLNoPublic HTTPS URL used in HTTP + OAuth mode (e.g., https://projects.example.com). Required when using HTTP transport.
OPPEN_SCAN_ROOTSNoJSON array of directories to scan for projects, e.g., ["~/Projects", "~/Research"]. Defaults to the current user's home directory.
OPPEN_SKILL_ROOTNoDirectory containing the skill folders 'oppen-project-steward' and 'stepwise-r-project'. If not set, common locations like ~/.codex/skills and ~/.agents/skills are tried.
OPPEN_SCAN_SECONDSNoMax seconds per scan batch. Default is 90.90
OPPEN_EXCLUDE_ROOTSNoJSON array of directories to exclude from scanning, e.g., ["~/Projects/private"].
OPPEN_MAX_SCAN_DIRSNoMax directories to scan per batch. Default is 500000.500000
OPPEN_SCAN_INTERVALNoSeconds between scan cycles; minimum 10. Default is 300.300
OPPEN_TUNNEL_CLIENTNoFull path to the tunnel-client executable if it is not on your PATH.
OPPEN_TUNNEL_PROFILENoProfile name used for the tunnel-client. Default is 'oppen-steward'.oppen-steward
CONTROL_PLANE_API_KEYNoRuntime key from OpenAI Platform for the tunnel, required when using Secure MCP Tunnel.
OPPEN_DISCUSSION_MODENoDiscussion feature mode: 'off' (default), 'read' to allow reading discussion files, or 'write' to allow reading and creating/editing discussions.off
OPPEN_EXTRA_REDIRECT_URISNoJSON array of extra allowed OAuth redirect URIs. Default is [].

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

Features and capabilities supported by this server

Protocol revision2025-11-25

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

Tools

Functions exposed to the LLM to take actions

NameDescription
list_projectsA

List discovered projects, stable IDs, roots and skill versions. Use offset for pagination.

refresh_projectsA

Rescan local roots for projects, or resume an incomplete scan. No project files are modified.

project_overviewC

Read the registry, locate indices and report this connection's Discussion permissions.

discussion_mode describes local configuration; discussion_access describes authorization. mcp_tools is the live server list, which may differ from an older client's cached tool list.

list_filesA

Browse registry and indexed Memory/Attention paths. Use list_discussions for Discussion.

read_fileA

Read an allowlisted governance document in chunks. Offsets/lengths are BYTES.

Follow next_offset to EOF; compare size/modified_ns across chunks and restart if changed. Maximum chunk 262144 bytes; base64 preserves exact bytes of allowed governance text. Data, source, results, Audit, README and other canonical bodies are never available. Discussion uses read_discussion and its separate permission; this tool cannot read Discussion.

searchA

Search only allowlisted governance documents across projects; returns citation IDs for fetch.

Content search covers UTF-8 files up to 256 KiB. Narrow project_id/glob if truncated.

fetchB

Fetch a search result by ID. Follow metadata.next_offset to read a long document completely.

get_skill_guideB

Read the locally installed SKILL.md for either supported management skill.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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/HaobinZhou/OppenSteward-MCP'

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