Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
STATE_MEMORY_MCP_DIRNoAbsolute path to directory where database files are stored..state-memory-mcp/
STATE_MEMORY_WAL_MODENoSQLite journal mode (WAL, DELETE, TRUNCATE, PERSIST, MEMORY, OFF).WAL
ALLOW_PRIVATE_WEBHOOKSNoAlias flag for private network webhook dispatch approval.false
STATE_MEMORY_ADMIN_KEYNoSecret token required to execute administrative operations like prune_events.undefined
STATE_MEMORY_READ_ONLYNoForces server into read-only access mode (true/false).false
STATE_MEMORY_ADMIN_MODENoEnables administrative mode globally (true/false).false
STATE_MEMORY_AUDIT_ONLYNoForces server into audit-only access mode (true/false).false
STATE_MEMORY_MCP_PROJECTNoActive project slug identifier override.Auto-resolved from project directory
STATE_MEMORY_WEBHOOK_URLNoWebhook HTTP POST endpoint for real-time state change notifications.undefined
STATE_MEMORY_BUSY_TIMEOUTNoSQLite database lock busy timeout in milliseconds.5000
STATE_MEMORY_MAX_DB_BYTESNoMaximum database size safety limit in bytes before rejecting writes.5368709120
STATE_MEMORY_STRICT_AUDITNoEnforces strict cryptographic event log verification.false
STATE_MEMORY_MCP_LOG_LEVELNoLogging verbosity on stderr (debug, info, warn, error).info
STATE_MEMORY_ENCRYPTION_KEYNoHex or string key for AES-256-GCM metadata payload encryption at rest.undefined
STATE_MEMORY_WEBHOOK_SECRETNoSecret token sent as Authorization: Bearer <secret> in webhook headers.undefined
STATE_MEMORY_WEBHOOK_TIMEOUTNoWebhook HTTP POST timeout in milliseconds.5000
STATE_MEMORY_MCP_DEFAULT_BRANCHNoFallback branch name if Git cannot be queried on startup.main
STATE_MEMORY_CYCLE_DETECTION_MODENoGraph cycle detection policy (strict or best_effort).strict
STATE_MEMORY_ALLOW_PRIVATE_WEBHOOKSNoAllows dispatching webhooks to local/private network IP addresses.false

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
manage_nodesC

Manage graph nodes in the state graph. Supported actions: create (add single node), update (modify node properties), get (fetch node with edges), remove (delete node and cascade edges), list (filter nodes), search (FTS5 or TF-IDF search), batch_create (create multiple nodes atomically), batch_update (update multiple nodes atomically), add_note (log observation node with optional context link).

manage_edgesB

Manage typed graph relationships between nodes. Supported actions: add (create typed relationship), remove (delete relationship), batch_add (create multiple relationships atomically), link_visual (link task or artifact to visual memory state).

manage_sessionsA

Manage agent tracking sessions and multi-turn workflow attribution. Supported actions: start (begin tracked session), end (conclude session), list (view active/historical sessions), bootstrap (single-turn start + context snapshot + next tasks).

manage_tasksB

Task prioritization, workflow execution, blockers, and stale task management. Supported actions: next (query prioritized unblocked tasks), complete (mark done and optionally create artifact), find_blocked (find tasks blocked by a decision), find_stale (find idle/untouched tasks), find_blockers (find active blockers), find_similar_blockers (TF-IDF search for previously resolved blockers), auto_prune (cancel stale in-progress tasks).

manage_snapshotsB

State checkpointing, time travel, diffing, and undo operations. Supported actions: save (create named checkpoint), list (list checkpoints), diff (compare two snapshots), get_state (reconstruct graph state at historical timestamp), revert (rollback graph to historical timestamp), undo (revert last mutation on a node), get_history (chronological audit log for a node).

manage_specsA

Spec-Driven Development (SDD) lifecycle and workflow template generation. Supported actions: scaffold (generate spec template in .specs/), ingest (parse PRD/Gherkin into graph nodes), export (export spec node back to Markdown/Gherkin), compliance (calculate requirement coverage matrix), verify (mark acceptance criterion verified/failing), decompose_feature (decompose feature into plan/milestones/subtasks), template (scaffold FDD or RFC template).

manage_databaseB

Physical SQLite database maintenance, backups, integrity checks, and Git VCS state sync. Supported actions: backup (online SQLite backup), restore (destructive restore from backup), audit (foreign keys and physical integrity check), merge (merge external SQLite state DB), branch_diff (diff state nodes across git branches), branch_merge (resolve graph conflicts during branch merge).

manage_dataB

Export and import graph structures, issue tracker items, fine-tuning trajectories, and multimodal synergy metrics. Supported actions: export_graph (export to JSON/DOT/Mermaid/HTML), export_issues (export to GitHub/Jira JSON), export_trajectories (export JSONL fine-tuning data), export_joint_trajectories (export interleaved state + vision data), export_synergy_metrics (compute dual-memory metrics), import_graph (bulk import nodes & edges), import_issues (import GitHub/Jira issues), import_spec (import PRD/Gherkin spec).

query_graphA

Query graph topology, neighborhoods, dependency paths, and safe read-only SQL queries. Supported actions: subgraph (fetch N-hop neighborhood around root node), trace (trace dependency chain upstream or downstream with cycle detection), raw (execute safe read-only SELECT query against SQLite), natural_language (translate natural language query into graph operations).

get_analyticsA

Compute workflow metrics, velocity, burndown, cognitive load, decision lineages, and contradiction audits. Supported actions: summary (project overview), velocity (throughput and duration), burndown (time-series remaining tasks chart), value_metrics (token savings and ROI), cognitive_load (ICL and ECL context complexity), critical_path (longest unfinished task chain), context_snapshot (consolidated overview), decision_trail (trace decision lineage), find_related_decisions (find decisions related to an artifact), contradictions (audit for conflicting decisions or broken states).

get_eventsB

Inspect the append-only event audit ledger, query structured changesets, and generate session post-mortems. Supported actions: log (query event ledger with filters), changelog (get structured graph diff since timestamp or session), post_mortem (analyze a session and produce a structured markdown report).

run_diagnosticsB

Run graph sanity checks, health diagnostics, reference validation, audit chain verification, and storage maintenance. Supported actions: validate (check cycles, orphans, dangling edges), doctor (database WAL mode, schema version, storage health), check_refs (validate file paths and AST symbols with auto-heal), audit_chain (verify SHA-256 event hash integrity), compact (reclaim SQLite storage), archive (archive old completed tasks), prune_events (permanently prune events - admin mode required), version (retrieve package version info), dedupe (detect and merge duplicate nodes).

use_blackboardA

Multi-agent shared blackboard for asynchronous agent coordination. Supported actions: post (publish ephemeral notice with topic, content, and TTL expiration), read (read active non-expired blackboard notices).

Prompts

Interactive templates invoked by user choice

NameDescription
review-decisionsReview accepted design decisions and check for contradictions
triage-blockersReview and triage active blockers across the dependency graph

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

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