| name | mcp-memnet |
| description | MemNet MCP tools: cue then pin_map, GQL mutate, session, ingest, snap_model, export_pin_map, reserve. Triggers: memnet mcp, MCP pin_map, MCP mutate, session_open, find, ingest_sysml, snap_model, export_pin_map, reserve, RSV. |
| metadata | {"pattern":"tool-wrapper","version":"7.3","domain":"memnet","product":"memnet-llm==0.19.3"} |
| token_guardrails | - Product read is pin_map from a cue (kind / locators / keyword / session). leftover anchor= is leftover.
- Product write is mutate (CREATE/MERGE/SET/DELETE). leftover add/update / id:'NEW' are leftover façades.
- Parse envelope stdout. Wire SSOT: memnet-format + docs/grammar/gql-wire-profile.md.
|
MemNet MCP
Use MemNet via MCP. This checkout vendors the skill. Tool SSOT: parts/memnet-mcp/software/memnet_mcp/server.py. Wire: memnet-format. Nest: memnet-nested-sessions. Hub: memnet-use.
Hatch 0.19.3. Arg session (the id), not session_id (envelope may still return session_id). Novel-writer is out of scope.
Transport
| Role | How |
|---|
| Single agent | In-process memnet-mcp (stdio); no serve |
| Shared / Multitask | TCP :18765 or streamable-http; load memnet-multitask |
serve_status is a TCP probe. Skip it under default in-process.
Agent loop
session_open(map) → cue / find → pin_map → reason → mutate → pin_map
- Map —
session_open needs map_file or map_lines else no_map.
- Cue —
kind / locators (qname=, path=, goal=, …) / keyword / nickname cue. Empty cue = session outline (0.11). Ego unknown: find(limit=…) then pin_map from labels+props. Prefer one live TSK_*. When (|Q|>1), CueConflict — do not pick one root.
pin_map — one (S) per generate. MCP session= selects the stratum. Drop the prior map next turn. leftover anchor= / anchors= are leftover nicknames.mutate — sparse GraphElement CREATE / MATCH…SET/DELETE. No leftover id:'NEW' mint. Under RSV pass llm_id.- Persist if needed:
session_save (file) or live cabinet (0.7 Agens / 0.14 Neo4j). Agents MUST NOT talk Bolt.
MCP missing: skip MemNet; plain Markdown only.
Maps (this repo)
| Job | map_file |
|---|
| SysML ingest / Snap | parts/common/memnet/memnet/examples/schema.sysml.example.txt |
| Coding memory | …/schema.coding.example.txt |
| Path-B codebase ingest | …/schema.codebase.example.txt |
| Tech docs | …/schema.techdocs.example.txt |
| Skills / rules | …/schema.skills.example.txt |
| PCBA ATO | …/schema.pcba.example.txt |
| Game / toy | …/schema.example.txt — not SysML |
Product tools
| Tool | Role |
|---|
session_open | Map required |
session_list | Live ids plus `@STAT: sessions |
session_close | Close that id (SessionLifecycle; does not dump (S)) |
session_save / session_load / session_current | Snapshot / resume |
pin_map | Primary read. Empty q = outline. view=shell is grain on a seed, not outline |
find | Bounded seed (limit required). Not RAG |
mutate | Product Commit |
snap_model | One load tree → catalog + interiors (session= + qname=). Look: nested-sessions |
ingest_sysml / ingest_codebase / ingest_pcba / ingest_skills | Path-B locators into this session (1→1). Not Snap. Not export |
export_pin_map | Write out a cue pin_map as GQL. Not ingest. Not Absorb. Not .sysml reverse |
import_slice | Absorb a slice (not a whole (S)) |
reserve / extend / release | RSV; pass llm_id on mutate |
read_list | Enumerate by kind / where |
housekeep_stats | Caps |
session_acl_enable / session_acl_grant / session_acl_bind | CapsPolicy opt-in (off by default). Not full session_token modes |
leftover (do not teach as product)
| Name | Status |
|---|
add / update | leftover façades; still registered. Prefer mutate. Path-B session_open seed still uses leftover add internally |
query_warm | leftover alias of pin_map |
query_walk | leftover hop debug |
anchor= / --anchor | leftover nickname |
read_get | not on this MCP |
id:'NEW' | leftover mint; not product Commit |
Args: references/tool-parameters.md. Policy: references/mcp-policy.md. Map: references/tool-grammar.md.
MUST NOT
rag_query / ANN of (S) / dump (S) / stack (N) nested maps in one generate.- Invent ids already on the map. Pipe
@TAG / Layer / TOON as agent I/O.
- Treat ingest as pin-map export or as
.sysml reverse.
- Restore novel-writer tools.
