vss-query-analytics

name	vss-query-analytics
description	Query video analytics incidents, alerts, sensor data, and metrics from Elasticsearch via the VA-MCP server (port 9901). Use for any question about what happened in video — PPE violations, alerts, incidents, object counts, speeds, occupancy, or anything that requires looking up recorded events. This is the primary way to answer "what happened", "show me alerts", "any violations", "how many people", etc.
owner	NVIDIA
service	vss-sop
version	1.0.0
license	CC-BY-4.0 AND Apache-2.0
reviewed	"2026-06-23T00:00:00.000Z"
metadata	{"openclaw":{"emoji":"🔎","os":["linux"]},"author":"nvidia <[e-mail]>","tags":["vss","analytics","elasticsearch","mcp"]}

Video Analytics (VA-MCP)

Queries incidents, alerts, and metrics stored in Elasticsearch via MCP JSON-RPC at port 9901.

Overview

Use this skill to fetch real-time or historical telemetry and compliance records stored in Elasticsearch. Always run queries programmatically via the VA-MCP server.

Key capabilities:

• Getting incident details by unique identifier.
• Aggregating statistical trends (e.g. average people count over a time window).
• Searching for safety/PPE alerts across active video streams.

Prerequisites

• VA-MCP Running: Ensure the vss-va-mcp service is running on port 9901.
• Session Identification: All JSON-RPC queries require an active mcp-session-id fetched from an initialization header.

Instructions

1. Two-Step JSON-RPC Pattern

To make queries, execute two consecutive shell/curl commands:

1. Initialize Session: Perform a POST call to http://localhost:9901/mcp with an initialize JSON payload, and grep for the mcp-session-id header.
2. Execute Tool Call: Send a POST call to http://localhost:9901/mcp with the tools/call method, passing the session header and the desired parameters.

2. Available Tool Options

Replace the parameters under Step 2 to target specific services:

• video_analytics__get_incidents — list recent incidents.
• video_analytics__get_incident — inspect detailed object lists / metadata.
• video_analytics__get_sensor_ids — find registered sensor identifiers.
• video_analytics__get_places — find configured spatial tags.
• video_analytics__get_fov_histogram — plot density curves.
• video_analytics__analyze — calculate metrics like speed or occupancies.

Examples

Get Incidents (Standard Query)

# Step 1: initialize — get session ID from response HEADER
SESSION_ID=$(curl -si -X POST http://localhost:9901/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d  \
  | grep -i  | awk  |  -d )


curl -s -X POST http://localhost:9901/mcp \
  -H  \
  -H  \
  -H  \
  -d  \
  | grep  | sed  | jq -r