vss-query-analytics
Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports.
npx skills add NVIDIA-AI-Blueprints/video-search-and-summarization --skill vss-query-analytics --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
## Purpose Answer read-only analytics questions (incidents, metrics, sensor data) by routing through the VA-MCP server. ## Prerequisites - Active VSS deployment reachable on `$HOST_IP` (see `vss-deploy-profile`). - NGC credentials in `$NGC_CLI_API_KEY` and `$NVIDIA_API_KEY` for any image pulls. - `curl`, `jq`, and Docker available on the caller. ## Instructions Follow the routing tables and step-by-step workflows below. Each section that ends in *workflow*, *quick start*, or *flow* is intended to be executed top-to-bottom. ## Examples Worked end-to-end examples are kept under `evals/` (each `*.json` manifest contains a runnable scenario) and inline in the per-workflow `curl` blocks below. Run a Tier-3 evaluation with `nv-base validate <this-skill-dir> --agent-eval` to replay them. ## Limitations - Requires the matching VSS profile / microservice to be deployed and reachable from the caller. - NGC-hosted models and NIMs may be subject to rate-limits, GPU memory requirements, and license restrictions. - Concurrency, GPU memory, and storage limits depend on the host hardware and the profile's compose file. ## Troubleshooting - **Error**: REST call returns connection refused. **Cause**
- Purpose
- Prerequisites
- Instructions
- Examples
- Limitations
- Troubleshooting
- Deployment prerequisite
- REQUIRED: Two-Step Pattern (copy this exactly)
- Tool Reference
- videoanalyticsgetincidents
- videoanalyticsgetincident
- videoanalyticsgetsensorids
- videoanalyticsgetplaces
- videoanalyticsgetfovhistogram
curl -sf --max-time 5 "http://${HOST_IP}:9901/mcp" >/dev/null 2>&1 || \
curl -sf --max-time 5 "http://${HOST_IP}:9901/" >/dev/null
Step 1: initialize — get session ID from response HEADER
Step 2: call the tool using the session ID in the header
curl -s -X POST http://${HOST_IP:-localhost}:9901/mcp \
Recent incidents (all sensors)
For a specific sensor
Confirmed (VLM-verified) only
curl -sf --max-time 5 "http://${HOST_IP:-localhost}:9901/mcp" >/dev/nullWhat does the vss-query-analytics skill do?
Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports.
How do I install it?
Run `npx skills add NVIDIA-AI-Blueprints/video-search-and-summarization --skill vss-query-analytics --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From NVIDIA-AI-Blueprints/video-search-and-summarization, a repository with 1,773 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.