Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DISPLAYNoDisplay environment variable available to the server process, required by mss on Linux for X11 sessions
XAUTHORITYNoX11 authority file path for X11 sessions
WAYLAND_DISPLAYNoWayland display environment variable for Wayland sessions
XDG_RUNTIME_DIRNoRuntime directory for user-specific non-essential runtime files
SCREEN_MCP_CAPTURE_RESPONSE_MODENoResponse mode for capture_screenshot tool when using auto mode: base64 or image

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_monitorsA

List available monitors.

Use this first when the caller does not know which monitor index to target. index=0 is the virtual full desktop, index>=1 targets a specific monitor.

capture_screenshotA

Capture one screenshot in a single call.

Prefer this tool for small/medium payloads when a one-shot response is desired. For larger payloads or robust transport, use the session flow: start_screenshot_capture -> get_screenshot_manifest -> get_screenshot_chunk -> release_screenshot_capture.

Args: monitor_index: 0 captures the virtual full desktop, 1..N capture a specific monitor. image_format: png or jpeg. max_width: optional resize target width while preserving aspect ratio. quality: JPEG quality in [1, 100]. Ignored for PNG. response_mode: 'base64' (default), 'image' (native MCP image block), or 'auto' (resolved from SCREEN_MCP_CAPTURE_RESPONSE_MODE env var).

capture_timelineA

Capture a timeline in a single call.

Prefer this tool for short timelines when a one-shot JSON payload is acceptable. For larger timeline payloads or safer transport, use the session flow: start_timeline_capture -> get_timeline_manifest -> get_timeline_chunk -> release_timeline_capture.

  • Max duration is enforced by source constant TIMELINE_MAX_DURATION_SECONDS.

  • Capture rate is fixed by source constant TIMELINE_FPS (images/second).

  • Output is optimized for temporal reasoning by an LLM.

start_timeline_captureA

Capture a timeline and store it in a temporary chunked session.

Use this as step 1 of the chunked timeline flow. Next calls should be: get_timeline_manifest, then all get_timeline_chunk, then release_timeline_capture.

get_timeline_manifestA

Return timeline session metadata without the full payload.

Use this as step 2 after start_timeline_capture to discover total_chunks and validate integrity metadata.

get_timeline_chunkA

Return one JSON text chunk for a timeline session.

Use this after get_timeline_manifest; fetch chunks from chunk_index=0 to total_chunks-1 in order. Concatenate chunk_text values to reconstruct the full timeline JSON.

release_timeline_captureA

Release a timeline session and free memory.

Call this after reading all required chunks.

start_screenshot_captureA

Capture a screenshot and store it in a temporary server-side session.

Use this as step 1 of the chunked screenshot flow. Next calls should be: get_screenshot_manifest, then all get_screenshot_chunk, then release_screenshot_capture.

get_screenshot_manifestA

Return screenshot session metadata and an ASCII preview.

Use this as step 2 after start_screenshot_capture to discover total_chunks and preview content.

get_screenshot_chunkB

Return one base64 chunk for a screenshot session.

Fetch chunks from chunk_index=0 to total_chunks-1 and concatenate chunk_base64.

release_screenshot_captureA

Release a screenshot session and free memory.

Call this after reading all required chunks.

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/jeandelest/screen-mcp'

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