Skip to content
Agentmart
Submit a tool

State Memory MCP

Persistent workflow graph server tracking tasks, decisions, spatial entities, and blockers.

Connector by putervision · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 40
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/putervision-state-memory-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Persistent workflow graph server tracking tasks, decisions, spatial entities, and blockers.

Use cases: agent-memory, project-management

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
43 read · 40 write · 8 delete
Secrets
None asked for
Install scripts
None found
Runs as
Node.js package

Tools by what they do 91

Read from the source code; the running server may list different tools.

Read 43 · Look things up without changing anything.

  • app_version
  • audit_project_db
  • burndown_chart
  • critical_path
  • decision_trail
  • detect_contradictions
  • diff_snapshots
  • doctor_report
  • find_blocked_tasks
  • find_blockers
  • find_related_decisions
  • find_similar_blockers
Show 31 more tools
  • get_analytics
  • get_cognitive_load
  • get_context_snapshot
  • get_event_log
  • get_events
  • get_node
  • get_node_history
  • get_project_summary
  • get_spec_compliance
  • get_stale_nodes
  • get_state_at_timestamp
  • get_subgraph
  • get_synergy_metrics
  • impact_analysis
  • list_nodes
  • list_sessions
  • list_snapshots
  • natural_language_query
  • next_tasks
  • plan_and_decompose_feature
  • query_graph
  • read_blackboard
  • search_nodes
  • trace_dependencies
  • validate_graph
  • validate_memory_references
  • value_metrics
  • velocity_analytics
  • verify_audit_chain
  • verify_requirement
  • what_changed

Write 40 · Create, change, send or run things.

  • add_edge
  • add_node
  • add_note
  • archive_completed_nodes
  • backup_project_db
  • batch_add_edges
  • batch_create_nodes
  • batch_update
  • bootstrap_session
  • compact_graph
  • complete_task
  • end_session
Show 28 more tools
  • export_graph
  • export_issues
  • export_joint_trajectories
  • export_spec
  • export_trajectories
  • import_graph
  • import_issues
  • ingest_spec
  • link_visual_state
  • manage_data
  • manage_database
  • manage_sessions
  • manage_snapshots
  • manage_specs
  • manage_tasks
  • merge_project_db
  • post_blackboard
  • post_mortem_from_session
  • restore_project_db
  • run_diagnostics
  • save_snapshot
  • scaffold_spec
  • scaffold_template
  • start_session
  • undo_last
  • update_node
  • vcs_branch_sync
  • vcs_merge_resolution

Delete 8 · Delete, drop, revoke or wipe things.

  • auto_prune_stale_tasks
  • manage_edges
  • manage_nodes
  • prune_events
  • remove_edge
  • remove_node
  • revert_to_timestamp
  • use_blackboard

Network hosts it talks to 11

  • agentreasoningmcp.com · found in code
  • behaviormcp.com · found in code
  • fonts.googleapis.com · found in code
  • github.com · found in code
  • glama.ai · found in code
  • putervision.com · found in code
  • putervision.github.io · found in code
  • statememorymcp.com · found in code
  • unpkg.com · found in code
  • visionmemorymcp.com · found in code
  • worldmodelmcp.com · found in code

Files it touches

  • /usr/local/opt/nvm/nvm.sh
  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (91)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • add_edge[Deprecated] add_edge

    [DEPRECATED in v1.0] Legacy alias for manage_edges(action: "add"). Please migrate to manage_edges.

  • add_node[Deprecated] add_node

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "create"). Please migrate to manage_nodes.

  • add_note[Deprecated] add_note

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "add_note"). Please migrate to manage_nodes.

  • app_version[Deprecated] app_version

    [DEPRECATED in v1.0] Legacy alias for run_diagnostics(action: "version"). Please migrate to run_diagnostics.

  • archive_completed_nodes[Deprecated] archive_completed_nodes

    [DEPRECATED in v1.0] Legacy alias for run_diagnostics(action: "archive"). Please migrate to run_diagnostics.

  • audit_project_db[Deprecated] audit_project_db

    [DEPRECATED in v1.0] Legacy alias for manage_database(action: "audit"). Please migrate to manage_database.

  • auto_prune_stale_tasks[Deprecated] auto_prune_stale_tasks

    [DEPRECATED in v1.0] Legacy alias for manage_tasks(action: "auto_prune"). Please migrate to manage_tasks.

  • backup_project_db[Deprecated] backup_project_db

    [DEPRECATED in v1.0] Legacy alias for manage_database(action: "backup"). Please migrate to manage_database.

  • batch_add_edges[Deprecated] batch_add_edges

    [DEPRECATED in v1.0] Legacy alias for manage_edges(action: "batch_add"). Please migrate to manage_edges.

  • batch_create_nodes[Deprecated] batch_create_nodes

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "batch_create"). Please migrate to manage_nodes.

  • batch_update[Deprecated] batch_update

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "batch_update"). Please migrate to manage_nodes.

  • bootstrap_session[Deprecated] bootstrap_session

    [DEPRECATED in v1.0] Legacy alias for manage_sessions(action: "bootstrap"). Please migrate to manage_sessions.

  • burndown_chart[Deprecated] burndown_chart

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "burndown"). Please migrate to get_analytics.

  • compact_graph[Deprecated] compact_graph

    [DEPRECATED in v1.0] Legacy alias for run_diagnostics(action: "compact"). Please migrate to run_diagnostics.

  • complete_task[Deprecated] complete_task

    [DEPRECATED in v1.0] Legacy alias for manage_tasks(action: "complete"). Please migrate to manage_tasks.

Show 76 more tools
  • critical_path[Deprecated] critical_path

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "critical_path"). Please migrate to get_analytics.

  • decision_trail[Deprecated] decision_trail

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "decision_trail"). Please migrate to get_analytics.

  • detect_contradictions[Deprecated] detect_contradictions

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "contradictions"). Please migrate to get_analytics.

  • diff_snapshots[Deprecated] diff_snapshots

    [DEPRECATED in v1.0] Legacy alias for manage_snapshots(action: "diff"). Please migrate to manage_snapshots.

  • doctor_report[Deprecated] doctor_report

    [DEPRECATED in v1.0] Legacy alias for run_diagnostics(action: "doctor"). Please migrate to run_diagnostics.

  • end_session[Deprecated] end_session

    [DEPRECATED in v1.0] Legacy alias for manage_sessions(action: "end"). Please migrate to manage_sessions.

  • export_graph[Deprecated] export_graph

    [DEPRECATED in v1.0] Legacy alias for manage_data(action: "export_graph"). Please migrate to manage_data.

  • export_issues[Deprecated] export_issues

    [DEPRECATED in v1.0] Legacy alias for manage_data(action: "export_issues"). Please migrate to manage_data.

  • export_joint_trajectories[Deprecated] export_joint_trajectories

    [DEPRECATED in v1.0] Legacy alias for manage_data(action: "export_joint_trajectories"). Please migrate to manage_data.

  • export_spec[Deprecated] export_spec

    [DEPRECATED in v1.0] Legacy alias for manage_specs(action: "export"). Please migrate to manage_specs.

  • export_trajectories[Deprecated] export_trajectories

    [DEPRECATED in v1.0] Legacy alias for manage_data(action: "export_trajectories"). Please migrate to manage_data.

  • find_blocked_tasks[Deprecated] find_blocked_tasks

    [DEPRECATED in v1.0] Legacy alias for manage_tasks(action: "find_blocked"). Please migrate to manage_tasks.

  • find_blockers[Deprecated] find_blockers

    [DEPRECATED in v1.0] Legacy alias for manage_tasks(action: "find_blockers"). Please migrate to manage_tasks.

  • find_related_decisions[Deprecated] find_related_decisions

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "find_related_decisions"). Please migrate to get_analytics.

  • find_similar_blockers[Deprecated] find_similar_blockers

    [DEPRECATED in v1.0] Legacy alias for manage_tasks(action: "find_similar_blockers"). Please migrate to manage_tasks.

  • get_analytics

    Compute workflow metrics, velocity, burndown, cognitive load, decision lineages, and contradiction audits (actions: summary, velocity, burndown, value_metrics, cognitive_load, critical_path, context_snapshot, active_context, decision_trail, find_related_decisions, contradictions). Use get_analytics instead of query_graph when calculating high-level progress statistics, ROI metrics, or auditing decision conflicts. Returns summary dashboard, velocity charts, burndown series, cognitive load metrics, critical path DAG, or contradiction reports.

  • get_cognitive_load[Deprecated] get_cognitive_load

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "cognitive_load"). Please migrate to get_analytics.

  • get_context_snapshot[Deprecated] get_context_snapshot

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "context_snapshot"). Please migrate to get_analytics.

  • get_event_log[Deprecated] get_event_log

    [DEPRECATED in v1.0] Legacy alias for get_events(action: "log"). Please migrate to get_events.

  • get_events

    Inspect the append-only event audit ledger, query structured changesets, and generate session post-mortems (actions: log, changelog, post_mortem). Use get_events instead of manage_snapshots when examining the granular chronological sequence of mutations rather than restoring state checkpoints. Returns chronological event array, structured changeset diff, or session post-mortem markdown report.

  • get_node[Deprecated] get_node

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "get"). Please migrate to manage_nodes.

  • get_node_history[Deprecated] get_node_history

    [DEPRECATED in v1.0] Legacy alias for manage_snapshots(action: "get_history"). Please migrate to manage_snapshots.

  • get_project_summary[Deprecated] get_project_summary

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "summary"). Please migrate to get_analytics.

  • get_spec_compliance[Deprecated] get_spec_compliance

    [DEPRECATED in v1.0] Legacy alias for manage_specs(action: "compliance"). Please migrate to manage_specs.

  • get_stale_nodes[Deprecated] get_stale_nodes

    [DEPRECATED in v1.0] Legacy alias for manage_tasks(action: "find_stale"). Please migrate to manage_tasks.

  • get_state_at_timestamp[Deprecated] get_state_at_timestamp

    [DEPRECATED in v1.0] Legacy alias for manage_snapshots(action: "get_state"). Please migrate to manage_snapshots.

  • get_subgraph[Deprecated] get_subgraph

    [DEPRECATED in v1.0] Legacy alias for query_graph(action: "subgraph"). Please migrate to query_graph.

  • get_synergy_metrics[Deprecated] get_synergy_metrics

    [DEPRECATED in v1.0] Legacy alias for manage_data(action: "export_synergy_metrics"). Please migrate to manage_data.

  • impact_analysis[Deprecated] impact_analysis

    [DEPRECATED in v1.0] Legacy alias for query_graph(action: "trace"). Please migrate to query_graph.

  • import_graph[Deprecated] import_graph

    [DEPRECATED in v1.0] Legacy alias for manage_data(action: "import_graph"). Please migrate to manage_data.

  • import_issues[Deprecated] import_issues

    [DEPRECATED in v1.0] Legacy alias for manage_data(action: "import_issues"). Please migrate to manage_data.

  • ingest_spec[Deprecated] ingest_spec

    [DEPRECATED in v1.0] Legacy alias for manage_specs(action: "ingest"). Please migrate to manage_specs.

  • link_visual_state[Deprecated] link_visual_state

    [DEPRECATED in v1.0] Legacy alias for manage_edges(action: "link_visual"). Please migrate to manage_edges.

  • list_nodes[Deprecated] list_nodes

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "list"). Please migrate to manage_nodes.

  • list_sessions[Deprecated] list_sessions

    [DEPRECATED in v1.0] Legacy alias for manage_sessions(action: "list"). Please migrate to manage_sessions.

  • list_snapshots[Deprecated] list_snapshots

    [DEPRECATED in v1.0] Legacy alias for manage_snapshots(action: "list"). Please migrate to manage_snapshots.

  • manage_data

    Export and import graph structures, issue tracker items, fine-tuning trajectories, and multimodal synergy metrics (actions: export_graph, export_issues, export_trajectories, export_joint_trajectories, export_synergy_metrics, from_tick, import_graph, import_issues, import_spec). Use manage_data instead of query_graph when bulk-transferring graph data or generating AI training datasets. Returns serialized graph payload, trajectory dataset, synergy metrics, or import statistics.

  • manage_database

    Physical SQLite database maintenance, backups, integrity checks, and Git VCS state sync (actions: backup, restore, audit, merge, branch_diff, branch_merge). Use manage_database instead of manage_snapshots when managing physical SQLite files, cross-branch merges, or database corruption audits. Returns database backup path, foreign key integrity report, branch merge conflict report, or diff.

  • manage_edges

    Manage typed graph relationships between nodes (actions: add, remove, batch_add, link_visual). Use manage_edges instead of manage_nodes when creating or modifying relationships between existing entities rather than entity data itself. Returns created edge record, batch count, or visual link confirmation.

  • manage_nodes

    Manage graph nodes in the state graph (actions: create, update, get, remove, list, search, batch_create, batch_update, add_note). Use manage_nodes instead of manage_tasks when operating on general node types (decisions, artifacts, plans, milestones, blockers) rather than runnable task workflow states. Returns node object, edge connections, batch results, or search matches.

  • manage_sessions

    Manage agent tracking sessions and multi-turn workflow attribution (actions: start, end, list, bootstrap). Use manage_sessions instead of manage_tasks when establishing agent session boundaries and tracking multi-turn workflows rather than individual work items. Returns session record, bootstrap context snapshot, or active session listing.

  • manage_snapshots

    State checkpointing, time travel, diffing, and undo operations (actions: save, list, diff, get_state, revert, undo, get_history). Use manage_snapshots instead of manage_database when reverting state graph mutations or comparing checkpoints rather than physical database file maintenance. Returns snapshot record, state graph diff, historical graph state, or node audit history.

  • manage_specs

    Spec-Driven Development (SDD) lifecycle and workflow template generation (actions: scaffold, ingest, export, compliance, verify, decompose_feature, template). Use manage_specs instead of manage_nodes when authoring, ingesting, or verifying formal SDD specifications against acceptance criteria. Returns specification AST, compliance matrix, verification verdict, or decomposed feature plan.

  • manage_tasks

    Task prioritization, workflow execution, blockers, and stale task management (actions: next, complete, find_blocked, find_stale, find_blockers, find_similar_blockers, auto_prune). Use manage_tasks instead of query_graph when querying runnable tasks by priority order or resolving execution blockers. Returns prioritized runnable tasks, blocker hierarchy, similar resolved blockers, or completion confirmation.

  • merge_project_db[Deprecated] merge_project_db

    [DEPRECATED in v1.0] Legacy alias for manage_database(action: "merge"). Please migrate to manage_database.

  • natural_language_query[Deprecated] natural_language_query

    [DEPRECATED in v1.0] Legacy alias for query_graph(action: "natural_language"). Please migrate to query_graph.

  • next_tasks[Deprecated] next_tasks

    [DEPRECATED in v1.0] Legacy alias for manage_tasks(action: "next"). Please migrate to manage_tasks.

  • plan_and_decompose_feature[Deprecated] plan_and_decompose_feature

    [DEPRECATED in v1.0] Legacy alias for manage_specs(action: "decompose_feature"). Please migrate to manage_specs.

  • post_blackboard[Deprecated] post_blackboard

    [DEPRECATED in v1.0] Legacy alias for use_blackboard(action: "post"). Please migrate to use_blackboard.

  • post_mortem_from_session[Deprecated] post_mortem_from_session

    [DEPRECATED in v1.0] Legacy alias for get_events(action: "post_mortem"). Please migrate to get_events.

  • prune_events[Deprecated] prune_events

    [DEPRECATED in v1.0] Legacy alias for run_diagnostics(action: "prune_events"). Please migrate to run_diagnostics.

  • query_graph

    Query graph topology, neighborhoods, dependency paths, safe read-only SQL queries, and compact System One task slices (actions: subgraph, trace, raw, natural_language, compact_slice). Use query_graph instead of get_analytics when exploring graph topology and path traversals rather than aggregated numerical metrics. Returns subgraph nodes and edges, upstream/downstream trace path, raw SQL rows, or compact task slice.

  • read_blackboard[Deprecated] read_blackboard

    [DEPRECATED in v1.0] Legacy alias for use_blackboard(action: "read"). Please migrate to use_blackboard.

  • remove_edge[Deprecated] remove_edge

    [DEPRECATED in v1.0] Legacy alias for manage_edges(action: "remove"). Please migrate to manage_edges.

  • remove_node[Deprecated] remove_node

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "remove"). Please migrate to manage_nodes.

  • restore_project_db[Deprecated] restore_project_db

    [DEPRECATED in v1.0] Legacy alias for manage_database(action: "restore"). Please migrate to manage_database.

  • revert_to_timestamp[Deprecated] revert_to_timestamp

    [DEPRECATED in v1.0] Legacy alias for manage_snapshots(action: "revert"). Please migrate to manage_snapshots.

  • run_diagnostics

    Run graph sanity checks, health diagnostics, reference validation, audit chain verification, and storage maintenance (actions: validate, doctor, check_refs, audit_chain, compact, archive, prune_events, version, dedupe). Use run_diagnostics instead of get_analytics when performing database repair, AST reference auto-healing, or verifying SHA-256 event hash chains. Returns validation diagnostics, health report, broken reference repair log, Merkle chain audit, or maintenance stats.

  • save_snapshot[Deprecated] save_snapshot

    [DEPRECATED in v1.0] Legacy alias for manage_snapshots(action: "save"). Please migrate to manage_snapshots.

  • scaffold_spec[Deprecated] scaffold_spec

    [DEPRECATED in v1.0] Legacy alias for manage_specs(action: "scaffold"). Please migrate to manage_specs.

  • scaffold_template[Deprecated] scaffold_template

    [DEPRECATED in v1.0] Legacy alias for manage_specs(action: "template"). Please migrate to manage_specs.

  • search_nodes[Deprecated] search_nodes

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "search"). Please migrate to manage_nodes.

  • start_session[Deprecated] start_session

    [DEPRECATED in v1.0] Legacy alias for manage_sessions(action: "start"). Please migrate to manage_sessions.

  • trace_dependencies[Deprecated] trace_dependencies

    [DEPRECATED in v1.0] Legacy alias for query_graph(action: "trace"). Please migrate to query_graph.

  • undo_last[Deprecated] undo_last

    [DEPRECATED in v1.0] Legacy alias for manage_snapshots(action: "undo"). Please migrate to manage_snapshots.

  • update_node[Deprecated] update_node

    [DEPRECATED in v1.0] Legacy alias for manage_nodes(action: "update"). Please migrate to manage_nodes.

  • use_blackboard

    Multi-agent shared blackboard for asynchronous coordination and mutex leases (actions: get, set, delete, lease, list, post, read). Use use_blackboard instead of manage_nodes when exchanging transient inter-agent messages or mutex resource leases rather than recording persistent graph knowledge. Returns blackboard message payload, lease acquisition status, active topic list, or deletion confirmation.

  • validate_graph[Deprecated] validate_graph

    [DEPRECATED in v1.0] Legacy alias for run_diagnostics(action: "validate"). Please migrate to run_diagnostics.

  • validate_memory_references[Deprecated] validate_memory_references

    [DEPRECATED in v1.0] Legacy alias for run_diagnostics(action: "check_refs"). Please migrate to run_diagnostics.

  • value_metrics[Deprecated] value_metrics

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "value_metrics"). Please migrate to get_analytics.

  • vcs_branch_sync[Deprecated] vcs_branch_sync

    [DEPRECATED in v1.0] Legacy alias for manage_database(action: "branch_diff"). Please migrate to manage_database.

  • vcs_merge_resolution[Deprecated] vcs_merge_resolution

    [DEPRECATED in v1.0] Legacy alias for manage_database(action: "branch_merge"). Please migrate to manage_database.

  • velocity_analytics[Deprecated] velocity_analytics

    [DEPRECATED in v1.0] Legacy alias for get_analytics(action: "velocity"). Please migrate to get_analytics.

  • verify_audit_chain[Deprecated] verify_audit_chain

    [DEPRECATED in v1.0] Legacy alias for run_diagnostics(action: "audit_chain"). Please migrate to run_diagnostics.

  • verify_requirement[Deprecated] verify_requirement

    [DEPRECATED in v1.0] Legacy alias for manage_specs(action: "verify"). Please migrate to manage_specs.

  • what_changed[Deprecated] what_changed

    [DEPRECATED in v1.0] Legacy alias for get_events(action: "changelog"). Please migrate to get_events.

Signals

Stars
40
Forks
3
Open issues
0
Contributors
1
Last commit
Oct 3, 2026 (25 days ago)
Last release
Oct 3, 2026 (25 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.putervision/state-memory-mcp
Version
1.4.1
Auth
No auth
Packages
npm @putervision/state-memory-mcp
License
MIT
Repository
github.com/putervision/state-memory-mcp
Website
statememorymcp.com
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from putervision

Cite this page

State Memory MCP. Agent Mart. https://agentmart.dev/connectors/putervision-state-memory-mcp (last updated 2026-10-24)