Convex

Convex

FieldValue
NamewatchState
TitleWatch State
DescriptionWatch a path in the global CVM state for changes. Returns a watchId. Changes are delivered as SSE notifications on the session's GET /mcp stream. Requires an active session (Mcp-Session-Id).
Input Schema
{
  "type": "object",
  "required": ["path"],
  "properties": {
                  "path": {
                            "type": "string",
                            "description": "CVM path vector into the global state, e.g. '[:accounts #56785 :environment myvar]'"
                          }
                }
}
Output Schema
{
  "type": "object",
  "properties": {
                  "value": {
                             "description": "Current value at the path (if small enough, otherwise omitted)"
                           },
                  "changed": {
                               "type": "boolean",
                               "description": "Always true if value included"
                             },
                  "watchId": {
                               "type": "string",
                               "description": "Unique watch identifier for unwatchState"
                             }
                }
}