Developer-tools MCP server

XMemo

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Package@xmemo/client
Latest analyzed version0.4.193
Current tool count20
Latest analysisNov 16, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed0.4.191 → 0.4.193Latest: 0.4.193
  • read10
  • write5
  • destructive1
  • unknown4

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
@xmemo/client@0.4.193
Registry
npm
Published
Oct 27, 2026
Integrity
sha512-RuiGtD6maj+mz977XsJ8uCDCIBr/spe+qEsnBKZhWioOPsBn30Z0PEirnGeA8P82swgKOst4879CIcC6Yn0QwQ==
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/yonro/memory-os-cli

20 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
add_expenseyonro-xmemo:tool:add_expense
Observed interface and hashes

Create one XMemo Ledger transaction and backing memory. Requires memory:write; it records a new transaction or reuses a semantic duplicate, and never deletes Ledger records. Use it for a purchase, income, refund, or transfer; use list_ledger_transactions or get_monthly_ledger_summary for reads. amount must be positive; transaction_type defaults to expense; blank transaction_date uses today's UTC date.

Input schema

{
  "properties": {
    "agent_id": {
      "default": "",
      "description": "Optional client-supplied agent label for memory attribution.",
      "type": "string"
    },
    "agent_instance_id": {
      "default": "",
      "description": "Optional stable, non-secret agent instance ID for per-client attribution.",
      "type": "string"
    },
    "amount": {
      "description": "Positive transaction amount; zero and negative values are rejected.",
      "type": "number"
    },
    "bucket": {
      "default": "private",
      "description": "Bucket for the backing memory; defaults to private.",
      "type": "string"
    },
    "category": {
      "default": "",
      "description": "Optional Ledger category, such as food, transport, or electronics.",
      "type": "string"
    },
    "currency": {
      "default": "CNY",
      "description": "Currency code or label; labels such as yen or RMB are normalized to codes.",
      "type": "string"
    },
    "device_id": {
      "default": "",
      "description": "Optional client-supplied device identifier for attribution.",
      "type": "string"
    },
    "device_label": {
      "default": "",
      "description": "Optional human-readable device label for attribution.",
      "type": "string"
    },
    "item": {
      "description": "Purchased item, income source, refund, or transfer label.",
      "type": "string"
    },
    "merchant": {
      "default": "",
      "description": "Optional merchant, payer, payee, or store name.",
      "type": "string"
    },
    "note": {
      "default": "",
      "description": "Optional note stored with the transaction.",
      "type": "string"
    },
    "path": {
      "default": "finance/ledger/expenses",
      "description": "Memory path; the default follows transaction_type for non-expenses.",
      "type": "string"
    },
    "payment_method": {
      "default": "",
      "description": "Optional payment method, such as card, cash, Alipay, or WeChat Pay.",
      "type": "string"
    },
    "project_id": {
      "default": "",
      "description": "Optional exact authorized project ID; stores the transaction in its private scope.",
      "type": "string"
    },
    "scope": {
      "default": "",
      "description": "Optional authorized scope; must match project_id when both are set.",
      "type": "string"
    },
    "team_id": {
      "default": "",
      "description": "Optional team attribution within the authorized scope.",
      "type": "string"
    },
    "transaction_date": {
      "default": "",
      "description": "YYYY-MM-DD transaction date; blank uses today's UTC date.",
      "type": "string"
    },
    "transaction_type": {
      "default": "expense",
      "description": "Transaction to create: expense, income, refund, or transfer.",
      "type": "string"
    }
  },
  "required": [
    "item",
    "amount"
  ],
  "type": "object"
}
sha256:202bb9780d45334a7ae6605fe68826bf76e9ef67ea8bd7e611bf8e5fbdb90f4e

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:832d6fbd485729369adf839cee822cb300b62b915285c6b711158ad48218b547

Interface hash: sha256:f6d859396cd8cc43ccb1db8d34f91542319f15d9a73d1a655f970fedb9bf61b8

Other observed Modelara metadata
{
  "id": "mcp:xmemo/add_expense",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "add_expense"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:0b6be2cf6c65ef2b4a9ef1a686a1f138165e9feafd883d1e3fe40c7955cbb2e8"
}
toolwrite0.4.191No change observed
complete_memory_todoyonro-xmemo:tool:complete_memory_todo
Observed interface and hashes

Mark a TODO/action item completed.

Input schema

{
  "properties": {
    "todo_id": {
      "description": "The memory TODO/action-item ID to complete.",
      "type": "string"
    }
  },
  "required": [
    "todo_id"
  ],
  "type": "object"
}
sha256:d8a364a7cdefccdfefdf732a92850054f154b00a799b88216984c7aec8d170a6

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:73ced30922629dbc5f84883d7a4283c1a8405cd5ab73164cc6661623229036b7

Interface hash: sha256:73d21b0b7d19b6605dbe69e3e4d0fbfa54f1cc8a0a0620498cba2f735f333f59

Other observed Modelara metadata
{
  "id": "mcp:xmemo/complete_memory_todo",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "complete_memory_todo"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:dde4295bcfa8dac99bf9425fcfb9c46623ad86c9e3581e6ac60f0bb524f462a1"
}
toolunknown0.4.191No change observed
create_memory_todoyonro-xmemo:tool:create_memory_todo
Observed interface and hashes

Create a TODO/action item with an optional due time.

Input schema

{
  "properties": {
    "content": {
      "description": "Text body of the TODO item.",
      "type": "string"
    },
    "due_at": {
      "description": "Optional due time.",
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:1cf5563e1563ebafffc3453a9fb50e35ba175f1fe07a0167eb57284deade4863

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:a888175304ab40cb27f9f494881faf0bb56ac4d8b8af2d91269fdcf06cbb7ac5

Interface hash: sha256:59f951b2c9ddba6b6c5ffca36d6f18f2cd73008728c004b6fbecff1d38755da6

Other observed Modelara metadata
{
  "id": "mcp:xmemo/create_memory_todo",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "create_memory_todo"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:28d208a8ca53b0c6fe5ca0dd1a617207b98ef7173fc6f0a7f7f9c0dc484feb4d"
}
toolwrite0.4.191No change observed
explain_memoryyonro-xmemo:tool:explain_memory
Observed interface and hashes

Explain why a memory exists or matched a query.

Input schema

{
  "properties": {
    "memory_id": {
      "description": "Exact XMemo memory reference.",
      "type": "string"
    },
    "query": {
      "description": "Optional explanation query.",
      "type": "string"
    }
  },
  "required": [
    "memory_id"
  ],
  "type": "object"
}
sha256:6590c017739e88d5d85de0695e352beb3dbb027f25e0f2cbeb84b268c7ba4a18

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:aab8806eafc85cb8da6beb3e80f2296cc9b9d4238e6a10070ccdf6f8ee2f61c9

Interface hash: sha256:8802327a26ea22510b9d687403f0d4cfd26f96febc8f49161f88d0ab0d123201

Other observed Modelara metadata
{
  "id": "mcp:xmemo/explain_memory",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "explain_memory"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:23663a7ff4e9d545d0a48f352889c2b657ae6188ed996d7e351857ed8c76556f"
}
toolread0.4.191No change observed
forgetyonro-xmemo:tool:forget
Observed interface and hashes

Permanently delete a memory by target.

Input schema

{
  "properties": {
    "reason": {
      "description": "Optional deletion reason.",
      "type": "string"
    },
    "target": {
      "description": "The memory to forget: current or an exact memory ID.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
sha256:3f68ac47044dee9c44d0402ab161709dac2b1b5711dd587e385a3d1584c964b2

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:7a9768d00e405a174ff3baa6f8719608e75358f9c0fff81fdce62ed94cd5b20b

Interface hash: sha256:8bef3c7b14aeec1e1da988fee90ebfbc0769a74ac36d005a1ae52de1c0870290

Other observed Modelara metadata
{
  "id": "mcp:xmemo/forget",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "forget"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:1abb1e6516c72473ed1ec88284a482036573746a62402ef41f936e3824b2a6ac"
}
tooldestructive0.4.191No change observed
get_mcp_identityyonro-xmemo:tool:get_mcp_identity
Observed interface and hashes

Check XMemo connection status and the connected account/agent.

Input schema

{
  "properties": {},
  "required": [],
  "type": "object"
}
sha256:e04efc6033e15f96acab8a6e820a6899b5b1ac29d97c613a159ee45c8260407a

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:7f690c0244e68970ebdf16cf4cdf0bcfde52921bf4a5077963772d5028348766

Interface hash: sha256:51f17b9ab063cce80aac7a0a6648b4da3f127a3be31e7e610e15762d6eba3ec5

Other observed Modelara metadata
{
  "id": "mcp:xmemo/get_mcp_identity",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "get_mcp_identity"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:f9b5b93556aa034ee5c0ceca03da5b7a2c7b9b7e9907cc28e4d8c38a2ffe5a19"
}
toolread0.4.191No change observed
get_monthly_ledger_summaryyonro-xmemo:tool:get_monthly_ledger_summary
Observed interface and hashes

Summarize Ledger totals by month and currency.

Input schema

{
  "properties": {
    "months": {
      "description": "Number of recent months to summarize.",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}
sha256:d2763d856a16a0b81dba6b51040749b0c55670793380fed4f9b8fb1d958526ac

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:7e9afd4ff4eea38e1c1d0088c52a95352600f06ae6772cba34bd1705d47e0ae0

Interface hash: sha256:0e8230f88f9019d0b5fb50f9deaef94c25ad9f2494bc652e87bc497ed25d832c

Other observed Modelara metadata
{
  "id": "mcp:xmemo/get_monthly_ledger_summary",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "get_monthly_ledger_summary"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:38caa9db4044454bbfa991e4bc29e5fe131331df49fa49647dc210cd4d720ec6"
}
toolread0.4.191No change observed
get_project_contextyonro-xmemo:tool:get_project_context
Observed interface and hashes

Read one authorized project's bounded context pack: state, TODOs, decisions, timeline, recent memories, and optional durable recall. Requires memory:read; it does not mutate project memories, and access is audit-logged. Use an exact project_id for a whole-project snapshot; otherwise use recall_context. max_items/max_tokens bound the whole pack; recent_hours affects only timeline; durable_query requires include_durable_context.

Input schema

{
  "properties": {
    "agent_id": {
      "default": "",
      "description": "Optional client-supplied agent label for memory attribution.",
      "type": "string"
    },
    "agent_instance_id": {
      "default": "",
      "description": "Optional stable, non-secret agent instance ID for per-client attribution.",
      "type": "string"
    },
    "bucket": {
      "default": "%",
      "description": "Accessible bucket filter; % includes all accessible buckets.",
      "type": "string"
    },
    "durable_query": {
      "default": "",
      "description": "Query only for durable recall; ignored when include_durable_context is false.",
      "type": "string"
    },
    "include_durable_context": {
      "default": true,
      "description": "Include semantic durable recall; false omits that section.",
      "type": "boolean"
    },
    "max_items": {
      "default": 100,
      "description": "Whole-pack item budget from 1 to 1000.",
      "type": "integer"
    },
    "max_tokens": {
      "default": 8000,
      "description": "Whole-pack approximate token budget from 1 to 50000.",
      "type": "integer"
    },
    "output_json": {
      "default": false,
      "description": "True returns the full structured pack; false returns a text summary.",
      "type": "boolean"
    },
    "project_id": {
      "description": "Exact authorized project ID; project names are not accepted.",
      "type": "string"
    },
    "recent_hours": {
      "default": 168,
      "description": "Timeline lookback from 1 to 8760 hours; other sections are unaffected.",
      "type": "integer"
    },
    "team_id": {
      "default": "",
      "description": "Optional exact authorized team focus; other team rows are excluded.",
      "type": "string"
    }
  },
  "required": [
    "project_id"
  ],
  "type": "object"
}
sha256:20bbf2220ab03e71cf1bcb3744b04a89a0ab6afecd5545584d3da88eb1a5d1bd

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:951f7b07b12520467299bb651bd50a80576b07dddc15b7fb17809e314b50891f

Interface hash: sha256:ba8f76422f4e1a7d14d1ee020733257182479914a61335ca8bbe29c86dcd98b7

Other observed Modelara metadata
{
  "id": "mcp:xmemo/get_project_context",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "get_project_context"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:08bccf8904f6ddc74754febb7701add9e37d5cd74aff5b956c946a90ce8d60b2"
}
toolread0.4.191No change observed
get_timelineyonro-xmemo:tool:get_timeline
Observed interface and hashes

Read authorized timeline events newest first. Requires memory:read and makes no memory changes. Use it for recent history or session resumption; use recall_context for semantic multi-memory context. limit is clamped to 1-500; session_id and event_type are exact filters.

Input schema

{
  "properties": {
    "bucket": {
      "default": "%",
      "description": "Accessible bucket filter; % includes all accessible buckets.",
      "type": "string"
    },
    "event_type": {
      "default": "",
      "description": "Optional exact event type after lowercase normalization.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum events to return; values are clamped to 1-500.",
      "type": "integer"
    },
    "scope": {
      "default": "",
      "description": "Optional authorized scope; blank uses the token default.",
      "type": "string"
    },
    "session_id": {
      "default": "",
      "description": "Optional exact session ID filter.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
sha256:8a0ab98408aa5fd0c2c325c51ba062eec3cc34cfa5275545812a0fe7491948aa

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:4f1b2041ef11bd5ea2e389195fe8405f87304fd6d02cb34b8e2b2fff073d5cdc

Interface hash: sha256:1019eb7f2640113ccb077e8c9f7e79c6e1a422ddfa575e7339ffe50dd71afb84

Other observed Modelara metadata
{
  "id": "mcp:xmemo/get_timeline",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "get_timeline"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:060b1f7391179137e2e3e71eaa8e7cc02ad33d3b77fdfc682f1d44b94484b772"
}
toolread0.4.191No change observed
list_ledger_transactionsyonro-xmemo:tool:list_ledger_transactions
Observed interface and hashes

Show XMemo Ledger records.

Input schema

{
  "properties": {
    "limit": {
      "description": "Maximum number of records.",
      "type": "integer"
    },
    "query": {
      "description": "Optional ledger search text.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}
sha256:0f968a1b15a9d810bd96e750a95384da2c70445c59283ce120d23fe12c6772c7

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:24f24612b15c74e8f14049952f8fc23a3c950eb9565a5003ebd727fb9d2494b6

Interface hash: sha256:f125af1545f90f1bfaaea53de09152810d44df790045e30a2eda3a909307c731

Other observed Modelara metadata
{
  "id": "mcp:xmemo/list_ledger_transactions",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "list_ledger_transactions"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:abbff73538dc6b7cd96b3702d14c4eee91c1e06bde96fd689d598eb276e3420b"
}
toolread0.4.191No change observed
list_memory_todosyonro-xmemo:tool:list_memory_todos
Observed interface and hashes

List open or completed TODO/action items.

Input schema

{
  "properties": {
    "item_status": {
      "description": "Optional TODO status filter.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of TODOs.",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}
sha256:0c656b1ca8371ed5f34ae05d2b3ae429249ff53918c1ca07cf9838102e463884

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:fc89c1fd91679c99c18faa9db79d0f7a61a87f761e5f54a45cb598ac5b1824e4

Interface hash: sha256:28ecb4f4a63cddef51e0ab1b79fe005ac57a16a6500abd67db1520e051e1b28a

Other observed Modelara metadata
{
  "id": "mcp:xmemo/list_memory_todos",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "list_memory_todos"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:5a06491480df84116a1686cc950df09a8a42931084943be4a3a953c752f42465"
}
toolread0.4.191No change observed
list_memory_versionsyonro-xmemo:tool:list_memory_versions
Observed interface and hashes

List available versions for a memory.

Input schema

{
  "properties": {
    "memory_id": {
      "description": "Exact XMemo memory reference.",
      "type": "string"
    }
  },
  "required": [
    "memory_id"
  ],
  "type": "object"
}
sha256:b04df56c70c2b2a10fdb89ccf8e0e876119d96bbede96072bfdc2727d8a7b764

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:c70bfc310a4a4ba3b96bc8acd358ebdc2b02ad2f528429f8c1c4a9325089ede7

Interface hash: sha256:3a2acd2451a544a0b91abed3c846077c19ade8b67dee611af91071b44d2470b0

Other observed Modelara metadata
{
  "id": "mcp:xmemo/list_memory_versions",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "list_memory_versions"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:1487caa40e2317d046675d09391af2ca15443b861a81d9b6d7827e9803f28924"
}
toolread0.4.191No change observed
memory_statsyonro-xmemo:tool:memory_stats
Observed interface and hashes

Show aggregate statistics for XMemo memories.

Input schema

{
  "properties": {},
  "required": [],
  "type": "object"
}
sha256:e04efc6033e15f96acab8a6e820a6899b5b1ac29d97c613a159ee45c8260407a

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:679492b872e75108aff938c10b9db468c5e7c54178236da10a35c96c05ff1848

Interface hash: sha256:07a2f9c8199d302f6019eb3ee241972574ee8275720d652f89772cbe54e6a5f4

Other observed Modelara metadata
{
  "id": "mcp:xmemo/memory_stats",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "memory_stats"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:91c0900ccc669eaad037650bd75bd7216a366f997cc792b2a5a4fef7694c0506"
}
toolread0.4.191No change observed
recallyonro-xmemo:tool:recall
Observed interface and hashes

Recall the most relevant saved memories before answering.

Input schema

{
  "properties": {
    "hypothetical_answer": {
      "description": "Optional multilingual hypothetical answer or dense semantic expansion written by the calling LLM for this query.",
      "type": "string"
    },
    "owner_timezone": {
      "description": "The user's real IANA timezone, such as Asia/Tokyo or America/Los_Angeles. Required for honest calendar periods; never guess UTC.",
      "type": "string"
    },
    "query": {
      "description": "Natural-language question or search text.",
      "type": "string"
    },
    "query_mode": {
      "description": "Optional query intent: 'topic' (default) or 'activity_log'. Trigger: Set 'activity_log' for event feeds within a bounded [since, until) window; set 'topic' for topic retrieval. Model responsibility: 'activity_log' requires explicit bounded 'since' and 'until' timestamps. Consequence: 'activity_log' without bounds fails closed; explicit 'topic' blocks stream bypass.",
      "enum": [
        "topic",
        "activity_log"
      ],
      "type": "string"
    },
    "reference_time": {
      "description": "Optional ISO 8601 reference time snapshot for deterministic evaluation. Leave blank to use the real clock; setting this does not replace owner_timezone for calendar day boundaries.",
      "type": "string"
    },
    "since": {
      "description": "RFC 3339 timestamp with timezone offset (e.g., '2026-09-01T00:00:00+09:00'). Trigger: Call this whenever the user query mentions any relative or absolute time constraint in any language (e.g., today, yesterday, last week, last month, recently, Aug 1, Aug 10 to Sep 1, since Monday, before Sep 15, in Q3). Model responsibility: You (the calling LLM) know current date and user local time, so you must convert natural language time expressions into absolute timestamps. Consequence: If omitted, the server falls back to heuristic guessing which may misinterpret timezone day boundaries or relative dates.",
      "type": "string"
    },
    "temporal_axis_mode": {
      "description": "Optional temporal axis resolution policy: 'created_at' (Scheme A), 'updated_at' (Scheme B), or 'split_filter_created_order_updated' (Scheme C).",
      "enum": [
        "created_at",
        "updated_at",
        "split_filter_created_order_updated"
      ],
      "type": "string"
    },
    "time_order": {
      "description": "Sort order for returned memories: 'desc' (newest first) or 'asc' (oldest first). Trigger: Pass 'desc' when the user asks for 'latest', 'recent', 'newest first', or recency, or 'asc' for chronological order ('oldest first') in any language. Model responsibility: Explicitly set desired temporal ordering when the user expresses recency intent. If omitted and since/until are omitted, default relevance ranking is used without temporal sorting.",
      "enum": [
        "desc",
        "asc"
      ],
      "type": "string"
    },
    "until": {
      "description": "RFC 3339 timestamp with timezone offset (e.g., '2026-09-02T00:00:00+09:00'). When used with since, defines the half-open interval [since, until) with until > since (maximum 90 days span). Trigger: Pass when the user query specifies an end date or bounded window in any language (e.g., yesterday end of day, by Aug 10, Aug 10 to Sep 1). Model responsibility: Convert natural language end bounds into absolute timestamps with timezone offsets. Consequence: If omitted, the window is open-ended on the upper side or derived heuristically.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
sha256:200800a029a07e4b1f2b83c421e5007edc3e7a3385a4c001040b10f7d018f1e0

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:8d2bf41e7629110837e1d1b795fbab834433826741aab79ae12de10ac656fc29

Interface hash: sha256:7ec4383a92cb7fe885588aa6b5b915ba02fdca5bbfb8e6329b76c86e24ef59b2

Other observed Modelara metadata
{
  "id": "mcp:xmemo/recall",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "recall"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:e0f9060c93faa10042e20333688cb696cb9effc2f6339eea8d8390ae38b3646c"
}
toolunknown0.4.191No change observed
recall_contextyonro-xmemo:tool:recall_context
Observed interface and hashes

Read a multi-memory context pack. Requires memory:read and does not change content. Use when many memories need explicit budgets; use recall for lightweight answer or get_project_context for project snapshot. max_items/max_tokens bound rendered output.

Input schema

{
  "properties": {
    "agent_id": {
      "default": "",
      "description": "Optional client-supplied agent label for memory attribution.",
      "type": "string"
    },
    "agent_instance_id": {
      "default": "",
      "description": "Optional stable, non-secret agent instance ID for per-client attribution.",
      "type": "string"
    },
    "bucket": {
      "default": "%",
      "description": "Accessible bucket filter; % includes all accessible buckets.",
      "type": "string"
    },
    "hypothetical_answer": {
      "description": "Optional multilingual hypothetical answer or dense semantic expansion written by the calling LLM for this query.",
      "type": "string"
    },
    "limit": {
      "default": 0,
      "description": "Candidate-result limit; 0 derives it from the item/token budgets.",
      "type": "integer"
    },
    "max_items": {
      "default": 8,
      "description": "Maximum memories rendered in the context pack.",
      "type": "integer"
    },
    "max_tokens": {
      "default": 1500,
      "description": "Approximate token budget for the rendered context pack.",
      "type": "integer"
    },
    "memory_type": {
      "default": "auto",
      "description": "Memory type filter; auto searches the normal mixed set.",
      "type": "string"
    },
    "output_json": {
      "default": false,
      "description": "True returns the full structured pack; false returns rendered context text.",
      "type": "boolean"
    },
    "owner_timezone": {
      "description": "The user's real IANA timezone, such as Asia/Tokyo or America/Los_Angeles. Required for honest calendar periods; never guess UTC.",
      "type": "string"
    },
    "path_filter": {
      "default": "%",
      "description": "Case-insensitive memory-path pattern; % matches all paths.",
      "type": "string"
    },
    "prefer_working": {
      "default": true,
      "description": "True prioritizes active working/session-state signals.",
      "type": "boolean"
    },
    "query": {
      "description": "Natural-language query used to rank memories for the context pack.",
      "type": "string"
    },
    "query_mode": {
      "description": "Optional query intent: 'topic' (default) or 'activity_log'. Trigger: Set 'activity_log' for event feeds within a bounded [since, until) window; set 'topic' for topic retrieval. Model responsibility: 'activity_log' requires explicit bounded 'since' and 'until' timestamps. Consequence: 'activity_log' without bounds fails closed; explicit 'topic' blocks stream bypass.",
      "enum": [
        "topic",
        "activity_log"
      ],
      "type": "string"
    },
    "reference_time": {
      "description": "Optional ISO 8601 reference time snapshot for deterministic evaluation. Leave blank to use the real clock; setting this does not replace owner_timezone for calendar day boundaries.",
      "type": "string"
    },
    "scope": {
      "default": "",
      "description": "Optional authorized scope; blank uses the token default.",
      "type": "string"
    },
    "since": {
      "description": "RFC 3339 timestamp with timezone offset (e.g., '2026-09-01T00:00:00+09:00'). Trigger: Call this whenever the user query mentions any relative or absolute time constraint in any language (e.g., today, yesterday, last week, last month, recently, Aug 1, Aug 10 to Sep 1, since Monday, before Sep 15, in Q3). Model responsibility: You (the calling LLM) know current date and user local time, so you must convert natural language time expressions into absolute timestamps. Consequence: If omitted, the server falls back to heuristic guessing which may misinterpret timezone day boundaries or relative dates.",
      "type": "string"
    },
    "team_id": {
      "default": "",
      "description": "Optional exact authorized team filter.",
      "type": "string"
    },
    "temporal_axis_mode": {
      "description": "Optional temporal axis resolution policy: 'created_at' (Scheme A), 'updated_at' (Scheme B), or 'split_filter_created_order_updated' (Scheme C).",
      "enum": [
        "created_at",
        "updated_at",
        "split_filter_created_order_updated"
      ],
      "type": "string"
    },
    "time_order": {
      "description": "Sort order for returned memories: 'desc' (newest first) or 'asc' (oldest first). Trigger: Pass 'desc' when the user asks for 'latest', 'recent', 'newest first', or recency, or 'asc' for chronological order ('oldest first') in any language. Model responsibility: Explicitly set desired temporal ordering when the user expresses recency intent. If omitted and since/until are omitted, default relevance ranking is used without temporal sorting.",
      "enum": [
        "desc",
        "asc"
      ],
      "type": "string"
    },
    "until": {
      "description": "RFC 3339 timestamp with timezone offset (e.g., '2026-09-02T00:00:00+09:00'). When used with since, defines the half-open interval [since, until) with until > since (maximum 90 days span). Trigger: Pass when the user query specifies an end date or bounded window in any language (e.g., yesterday end of day, by Aug 10, Aug 10 to Sep 1). Model responsibility: Convert natural language end bounds into absolute timestamps with timezone offsets. Consequence: If omitted, the window is open-ended on the upper side or derived heuristically.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
sha256:15ef1413d69e68a5118153da76f60232f5800eb0ad7927848020771088c2d8f0

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:0d4eb718f73bed053b5bb2e2d4dbbd06a007b786c0c28ded0ba6e44d5cfebaa8

Interface hash: sha256:776c2c3e6f001a2b8cc818e7db2e3b404bcfce1ef46528529780f0a8440aaec8

Other observed Modelara metadata
{
  "id": "mcp:xmemo/recall_context",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "recall_context"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:07e81189070c0dc9bd572f02f67d659b46c1c7fe89d37f1e740a82a968470cb1"
}
toolread0.4.191No change observed
record_eventyonro-xmemo:tool:record_event
Observed interface and hashes

Record a significant session event, milestone, or decision.

Input schema

{
  "properties": {
    "content": {
      "description": "Text body of the event.",
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:e8c2df8907ba35d550f76c5744d2a30d0e3828fe2b901688bc3b7f738365913a

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:c3c077ddb250944603994ee89fed6388e5fd3ab503cedbee1fceeeab08dd1a1b

Interface hash: sha256:450bce94e5db8d884040245c513d3be9bc74b8b5293f9d1a4904d308226bba2f

Other observed Modelara metadata
{
  "id": "mcp:xmemo/record_event",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "record_event"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:70ae2d3e9021a75f511121bb0080291d6514f571fa4cff0af4b7411fa74edbcd"
}
toolunknown0.4.191No change observed
rememberyonro-xmemo:tool:remember
Observed interface and hashes

Save a memory so it can be recalled in future conversations.

Input schema

{
  "properties": {
    "content": {
      "description": "Text body to save.",
      "type": "string"
    },
    "path": {
      "description": "Category path, e.g. preferences, projects/xmemo.",
      "type": "string"
    }
  },
  "required": [
    "content",
    "path"
  ],
  "type": "object"
}
sha256:4ea560e10bf68fb1ee15aaac7f798375be9b09629fc7bffb530bbc51460401f7

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:9e044f86e39c40a39abd3618546b410d8cd5a214f6326e9e7bf84954c24f8a85

Interface hash: sha256:b8f65392d19bc6579d0bc571838ad1e3e8c1ed761bade832143b9e7535e8631c

Other observed Modelara metadata
{
  "id": "mcp:xmemo/remember",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "remember"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:b3e2dad39c49afb015112455298b43aad758a49f6039313dbb7dbba8d1206cc6"
}
toolwrite0.4.191No change observed
restore_memoryyonro-xmemo:tool:restore_memory
Observed interface and hashes

Restore a previously deleted memory.

Input schema

{
  "properties": {
    "memory_id": {
      "description": "Exact XMemo memory reference.",
      "type": "string"
    },
    "reason": {
      "description": "Optional restore reason.",
      "type": "string"
    }
  },
  "required": [
    "memory_id"
  ],
  "type": "object"
}
sha256:d67658140eb1151e2c33c49a01a6fe96cbd7db4c2c36705d54cae13b128a9653

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:25aa7a272d7d6a80c284c5af8d15b3e1d9cb23e220180c452ec1bb5c82c15ca3

Interface hash: sha256:e14b09c305260c793e7c30a50d1f4b74d9a795e459151da406a5486841aabe65

Other observed Modelara metadata
{
  "id": "mcp:xmemo/restore_memory",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "restore_memory"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:1088bfe7fe0d5db9964317d0bd48dde1728481f8c4d01f28f6471999f9a85db1"
}
toolunknown0.4.191No change observed
update_memoryyonro-xmemo:tool:update_memory
Observed interface and hashes

Update the content or metadata of an existing memory.

Input schema

{
  "properties": {
    "content": {
      "description": "Replacement memory content.",
      "type": "string"
    },
    "memory_id": {
      "description": "Exact XMemo memory reference.",
      "type": "string"
    },
    "path": {
      "description": "Replacement memory path.",
      "type": "string"
    }
  },
  "required": [
    "memory_id"
  ],
  "type": "object"
}
sha256:cb7b4993f0ecef31d54c5c9d7c4c69827057119690163026014f36304f27649e

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:557330c9ab934a7ee7af61c16bb3f5155dee0983a8925dd5a987c66f8f0d42b7

Interface hash: sha256:78b1d866fc0febcdd8a064c99b1985c41edf3ef2ff5adfa591b323d0d13597e5

Other observed Modelara metadata
{
  "id": "mcp:xmemo/update_memory",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "update_memory"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:a6ef53e6befaadd555b07f2b7440bec9c8fb986fa5687b2c5faed5f9c10e4079"
}
toolwrite0.4.191No change observed
update_stateyonro-xmemo:tool:update_state
Observed interface and hashes

Create or replace one scoped working-state record for resuming a task, next action, or blocker. Requires memory:write; it versions that state slot and refreshes its expiry without deleting other memories. Use remember for durable facts or record_event for history. Provide content or a structured state field; ttl_seconds=0 means no expiry.

Input schema

{
  "properties": {
    "blocked_reason": {
      "default": "",
      "description": "Blocker; used to build the state body when content is blank.",
      "type": "string"
    },
    "bucket": {
      "default": "work",
      "description": "Bucket containing the working-state slot; defaults to work.",
      "type": "string"
    },
    "content": {
      "default": "",
      "description": "Free-form state body; otherwise provide at least one structured state field.",
      "type": "string"
    },
    "current_task": {
      "default": "",
      "description": "Current task; used to build the state body when content is blank.",
      "type": "string"
    },
    "metadata_json": {
      "default": "{}",
      "description": "JSON object merged into the working-state metadata.",
      "type": "string"
    },
    "next_action": {
      "default": "",
      "description": "Next action; used to build the state body when content is blank.",
      "type": "string"
    },
    "scope": {
      "default": "",
      "description": "Scope containing the working-state slot; blank uses the token default.",
      "type": "string"
    },
    "state_key": {
      "default": "active_task",
      "description": "Normalized state slot; the same owner, bucket, scope, and key updates that slot.",
      "type": "string"
    },
    "ttl_seconds": {
      "default": 86400,
      "description": "Expiry in seconds from 0 to 2592000; 0 means no expiry.",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}
sha256:dfb4693da6d37455e7bd7811d9313d582e2a0f2c0dbf905a4d38ca3f378a619d

Output schema

{
  "properties": {
    "result": {
      "description": "Human-readable text or JSON requested by output_json.",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
sha256:fbff89a9073541508a06f245769c68ea9cdcf335f9d18603f316d54b8ad30b19

Description hash: sha256:3235f2bac584cdd20be5bf7e17ef9f9c067286e6479834840208b6c20a63e718

Interface hash: sha256:d5ce8934aea1c1675c2506932ef7e79ad89ed8d065127d6709dda85972ee5126

Other observed Modelara metadata
{
  "id": "mcp:xmemo/update_state",
  "source": {
    "type": "mcp",
    "server": "xmemo",
    "operation": "update_state"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:6be5868a2c88850a6349d46c17d1189b3f94787542b246ad7b8b4af45873372f"
}
toolwrite0.4.191No change observed

STATIC COMPARISONS

Release history

2 release transitions
  1. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 16, 2026· Automated static analysis

  2. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 16, 2026· Automated static analysis