Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BI_URLNoThe base URL of the Blue Iris server. Defaults to http://localhost:81.http://localhost:81
BI_USERYesYour Blue Iris username.
BI_PASSWORDYesYour Blue Iris password.

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_camerasA

List configured Blue Iris cameras with live health status.

Each entry includes is_no_signal (true when the feed is down and Blue Iris is showing its grey "no video" placeholder -- this is different from is_online, which only means the camera isn't disabled), fps, error, and ptz_capable.

get_snapshotA

Fetch a JPEG frame from a camera.

Omit pos_ms for the current live frame. Pass pos_ms (Unix epoch milliseconds) to pull a historical frame instead -- use list_clips or list_alerts to find a timestamp of interest first (their date field is epoch seconds; multiply by 1000).

list_clipsA

List recorded video segments for a camera, newest first.

Covers Blue Iris's full retention window for that camera (typically a few days, depending on configured storage limits -- there's no separate date-range filter on this endpoint, it returns everything currently on disk). Each entry's date (epoch seconds) and msec (segment duration) can be used with get_snapshot to pull a frame from within that segment.

list_alertsA

List motion/AI alerts for a camera, newest first.

This is the fast path for "who/what triggered this camera and when" -- Blue Iris's own memo field carries AI recognition results when available (e.g. "Rahi:74%" for a matched face), so this often answers identity questions directly without a separate face-recognition lookup. date is epoch seconds, same convention as list_clips.

ptzA

Pan/tilt/zoom a PTZ-capable camera, or jump to a saved preset.

action is one of: left, right, up, down (momentary move, held for duration_s seconds, capped at 3.0), home, zoom_in, zoom_out, stop, or goto_preset (requires preset, 0-99).

Only cameras with PTZ hardware respond -- check list_cameras' ptz_capable field first. If this Blue Iris instance has an automated pipeline that also drives a camera's PTZ (e.g. a monitoring script using a dedicated preset slot), avoid sending competing PTZ commands to that camera at the same time -- Blue Iris does not arbitrate between simultaneous PTZ sources and the result is erratic movement.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.4/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: list_cameras for status, get_snapshot for frame retrieval, list_clips and list_alerts for historical data, and ptz for camera control. There is no overlap in functionality.

Naming Consistency4/5

Most tools follow the verb_noun pattern with snake_case (list_cameras, get_snapshot, list_clips, list_alerts). The exception is 'ptz', which is a concise, recognizable command name but breaks the verb_noun pattern slightly.

Tool Count5/5

The server exposes 5 tools, which is well-scoped for its purpose of interacting with a Blue Iris server. Each tool addresses a distinct need without excessive or inadequate coverage.

Completeness4/5

The tool set covers the core surveillance workflows: camera listing, snapshot retrieval, clip listing, alert listing, and PTZ control. Minor gaps exist such as lack of timeline traversal or configuration changes, but the surface is solid for common use cases.

Maintenance

ActivitySlowing
ResponsivenessNo issues