Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNolog levels (debug, info, warn, error)info
CLIP_MODELNoEmbedding model nameXenova/clip-vit-base-patch32
STRIP_EXIFNoStrip EXIF metadata from stored screenshotstrue
STRICT_MODENoRefuse external L4 calls & enforce projectRoot pathsfalse
LANCEDB_PATHNoStorage path for LanceDB.vision-memory-mcp
OFFLINE_MODENoRestrict CLIP loading to local files onlyfalse
OPENAI_API_KEYNoRequired if using OpenAI endpoints for L4 fallback
TTL_DEFAULT_MSNoEviction TTL (default: 7 days)604800000
CLIP_MODEL_PATHNoOptional local path to pre-downloaded CLIP model
VISION_MODEL_NAMENoVision model identifiergpt-4o
LANCEDB_CACHE_SIZENoMaximum hot items in LRU Cache100
LIMIT_INPUT_PIXELSNoSharp decompression bomb pixel limit16777216
MAX_LANCEDB_SIZE_MBNoEviction threshold (MB)1000
EMBEDDING_DIMENSIONSNoCLIP embedding output dimension512
HASH_EXACT_THRESHOLDNoHamming distance <= this = exact hit5
VISION_MODEL_ENABLEDNoEnable L4 vision fallbackfalse
VISION_MODEL_ENDPOINTNoVision model server URLhttp://localhost:1234/v1
HASH_SIMILAR_THRESHOLDNoHamming distance <= this = similar hit10

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": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
analyze_screenshotA

Ingest a screenshot or file path, check visual state cache, and return details of the state (generating a new memory entry if not matched).

recall_memoryA

Search visual state memory using screenshot image, text query, or accessibility tree.

record_outcomeA

Log an action transition between two visual states and update transition statistics.

get_navigation_pathsA

Trace historical pathways from current state to a target state or state matching description.

compare_statesA

Compare two states visually and structurally with key-level JSON diffs.

get_session_contextA

Fetch aggregated visual context, listing recent/frequent states and active transitions.

save_visual_snapshotA

Saves current visual memory states as a named checkpoint snapshot.

diff_visual_snapshotsA

Diff two snapshots to locate additions, deletions, or visual drift regressions.

undo_last_visual_mutationB

Undo the last visual state ingestion or transition edge addition.

create_visual_blockerA

Generates a structured visual blocker payload. The calling agent should use the output to call state-memory-mcp:add_node to log a blocker.

predict_next_actionA

Predict the best next UI action from current visual state based on transition success rates and goal alignment.

batch_analyze_screenshotsC

Process multiple screenshots or file paths in a single batch call.

set_visual_specA

Set a screenshot or mockup design as a Visual Spec baseline for UI compliance testing.

verify_visual_specA

Verify a live captured UI screenshot against a registered Visual Spec baseline.

list_visual_specsA

List all registered Visual Spec baselines across the project and their perceptual hash details.

get_visual_diffA

Calculate perceptual dHash diff and region deltas between two visual states.

export_visual_trajectoriesA

Export multimodal visual state transition trajectories for local model fine-tuning.

export_joint_trajectoriesB

Export unified interleaved visual state transitions and workflow graph events correlated by session/trace ID.

get_metricsA

Query cache-hit ratio, average visual similarity scores, and token-savings estimates.

export_snapshotA

Export a named visual snapshot as a full standalone JSON archive containing states, transitions, and metadata.

restore_snapshotB

Restore a visual memory snapshot from an exported archive JSON object.

forget_stateA

Purge a specific visual state, its vector embeddings, and perceptual hashes from storage for privacy or memory reset.

wait_for_visual_stateA

Poll for a target visual state ID until it exists in memory or timeout occurs, avoiding spinning agent loops.

app_versionA

Get version, package name, MCP identifier, and server information of vision-memory-mcp.

Prompts

Interactive templates invoked by user choice

NameDescription
analyze-ui-statePrompt for analyzing screen layout, key components, and actionable elements from a visual state record.
diagnose-visual-regressionPrompt for diagnosing visual differences between two snapshot checkpoints or visual states.
navigate-to-goalPrompt for finding and executing the optimal sequence of actions to reach a target visual state or goal.

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/putervision/vision-memory-mcp'

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