MCP server

niiro-mcp exposes the CLI and the portal to your coding agent.

What the agent gets

A thin wrapper around the same commands, plus read access to the portal: video status, which videos a change affects, and creating a video request. There is no second code path; MCP calls the CLI logic as a library.

niiro_init: Detects the stack and writes niiro.yml.
niiro_push: Scan, delta upload, affected videos.
niiro_status: Last sync and stale videos.
niiro_affected_videos: Which videos a change affects.
niiro_request_video: Creates a video order.

Installation

Add it to your agent's MCP configuration:

.mcp.json

{  "mcpServers": {    "niiro": {      "command": "npx",      "args": ["-y", "niiro-mcp"],      "env": { "NIIRO_TOKEN": "..." }    }  }}

Order a video

Order prompt

Goal: order a new niiro video.
Context: https://niiro.io/docs/mcp.md

1. Connect the niiro MCP server.
2. Check with niiro_status that the last push is current; push if it is not.
3. Ask me which flow the video should explain, then create the order with niiro_request_video.

Done when you report the order id from the portal.

Updated 2026-08-05