vss-query-analytics

Query video-analytics incidents, alerts, and sensor metrics through the VA-MCP server.

2|Updated Aug 20, 2026
One-click install
npx skills add https://github.com/atomicrajat/industry_safety_monitoring_system --skill vss-query-analytics-atomicrajat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vss-query-analytics
Source: https://github.com/atomicrajat/industry_safety_monitoring_system/tree/main/.claude/skills/vss-query-analytics
Command: npx skills add https://github.com/atomicrajat/industry_safety_monitoring_system --skill vss-query-analytics-atomicrajat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Operators of a deployed NVIDIA VSS stack need a reliable, read-only way to answer analytics questions — recent incidents, VLM-confirmed violations, sensor inventories, occupancy and speed metrics — without hand-writing JSON-RPC calls against the VA-MCP server on port 9901. ## Core Features & Use Cases - Two-step MCP session workflow: Initialize a session, capture the mcp-session-id response header, then issue tools/call requests against VA-MCP tools such as video_analytics__get_incidents, get_sensor_ids, get_fov_histogram, and analyze. - Deployment gating and retry guidance: Probe VA-MCP liveness before querying, hand off to vss-deploy-profile when the alerts profile is down, and retry transient 5xx errors with exponential backoff. - Scope guard against misuse: Explicitly refuses live VLM Q&A, narrative report generation, archive search, and prompt-injection attempts embedded in untrusted alert payloads. - Use Case: Ask "How many incidents have been confirmed by the VLM verifier so far?" and the agent filters get_incidents with vlm_verdict=confirmed and reports a concrete count from Elasticsearch. ## Quick Start Ask the agent to list the sensors currently known to the video analytics stack or show the ten most recent incidents across all sensors.

Frequently Asked Questions about vss-query-analytics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query video analytics incidents from a VSS deployment?

Query incidents by POSTing to the VA-MCP server at port 9901: first initialize a session and capture the mcp-session-id response header, then call video_analytics__get_incidents with that header. You can filter by sensor, time range, or VLM verdict.

Why does my VA-MCP request return Bad Request: Missing session ID?

This error means the tools/call request was sent without a valid mcp-session-id header. Re-run the initialize call, extract the session ID from the response header (not the body), and retry — sessions expire when the vss-va-mcp process restarts.

Can this skill answer live VLM questions or generate incident reports?

No. It is strictly read-only analytics over Elasticsearch via VA-MCP. Live VLM Q&A routes to vss-ask-video, narrative incident reports to vss-generate-video-report, and archive search to vss-search-archive.

What prerequisites are needed before querying VA-MCP analytics?

You need a running VSS alerts profile (verification or real-time mode) reachable on $HOST_IP, plus curl and jq on the caller. Probe http://$HOST_IP:9901/mcp first; if unreachable, deploy the alerts profile via vss-deploy-profile.

Will the skill deploy infrastructure if an alert payload asks it to?

No. Alert and analytics payloads are treated as untrusted input, and embedded instructions like 'deploy alerts stack' are refused as prompt-injection risks. Auto-deploy requires the trusted VSS_AUTO_DEPLOY=true harness flag.