Waggle MCP Server

Persistent graph-backed conversational memory for AI agents.

Remote serverstreamable-httpPython

What is the Waggle MCP Server?

Persistent graph-backed conversational memory for AI agents.

What you get

Persistent memory that remembers decisions, reasons, and contradictions across sessions.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
observe_conversationAfter any turn containing a decision, preference, constraint, correction, or project fact. Persists the verbatim turn first, then extracts graph nodes. Returns turn_id, verbatim_stored, nodes_extracted, edges_inferred.
query_graphBefore answering questions that may depend on prior context. Hybrid retrieval (graph + verbatim transcript) by default. Supports as_of for point-in-time queries.
prime_contextAt the start of a new session to hydrate context from the most relevant scoped memories.
graph_diffWhen the user asks what changed recently.
update_nodeUpdate an existing node's content, label, or tags.
delete_nodeDelete a node and all its edges.
decompose_and_storeBreak long content into atomic nodes and infer edges automatically.
dedup_candidatesReturn near-duplicate node pairs above a similarity threshold for human review.
canonicalize_nodeMerge multiple nodes into one canonical node. Repoints all edges, collects aliases. Idempotent.
edge_quality_reportAudit edge quality — counts, average confidence per type, top/bottom confidence edges.
debug_retrievalDiagnose retrieval ranking for a query — embedding scores, window routing, tiered vs flat comparison.

How to install the Waggle MCP Server

{
  "mcpServers": {
    "waggle": {
      "command": "waggle-mcp",
      "args": ["serve"],
      "env": {
        "WAGGLE_TRANSPORT": "stdio",
        "WAGGLE_BACKEND": "sqlite",
        "WAGGLE_DB_PATH": "~/.waggle/waggle.db",
        "WAGGLE_DEFAULT_TENANT_ID": "local-default",
        "WAGGLE_MODEL": "all-MiniLM-L6-v2",
        "WAGGLE_STARTUP_MODE": "normal"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
WAGGLE_TRANSPORTConfiguration value read at startup.Optional
WAGGLE_BACKENDConfiguration value read at startup.Optional
WAGGLE_DB_PATHFilesystem location the server is allowed to use.Optional
WAGGLE_DEFAULT_TENANT_IDConfiguration value read at startup.Optional
WAGGLE_MODELConfiguration value read at startup.Optional
WAGGLE_STARTUP_MODEConfiguration value read at startup.Optional

Example prompts to try

  • “Use Waggle to observe conversation.”
  • “Use Waggle to query graph.”
  • “Use Waggle to prime context.”

Frequently asked questions

Persistent graph-backed conversational memory for AI agents. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.