MCP for Claude

Connect Claude to your Niravi video corpus. Once added, Claude can search, recall, chat, and read every analysis on your videos — as native tools. Built on the Model Context Protocol; the tools are generated from the same OpenAPI spec as the SDKs, so they always track the API. Read-only.

Two ways to add it

	Remote connector	Local (stdio)
Works in	Claude web · desktop · mobile	Claude Desktop only
Setup	paste a URL	edit a config file
Requires	nothing	Node.js installed
Best for	most people	local/offline, advanced

Both are read-only and scoped to the workspaces your API key can reach. The local server (@niravi/mcp 0.2.0) has 37 tools; the remote connector serves the 24 tools of the earlier release until it is updated to 0.2.0.

Step 1 · Get an API key

Go to web.niravi.io → Settings → API access → Create key → set scope to Read → copy the nv_… secret (it’s shown once).

Use a dedicated read-only key for Claude — you can revoke it any time from the same page.

Step 2 · Option A — Remote connector (recommended)

In Claude: Settings → Connectors → Add custom connector, then fill in:

Field	What to enter
Name	`Niravi`
Remote MCP server URL	the URL below (with your key)
OAuth Client ID (advanced — optional)	leave blank
OAuth Client Secret (advanced — optional)	leave blank

Copy this into the Remote MCP server URL field, replacing nv_YOUR_KEY_HERE:

https://mcp.niravi.io/?key=nv_YOUR_KEY_HERE

Click Add — the Niravi tools appear.

Why the key is in the URL: the connector dialog has no separate key field, so the key rides on the URL. Leave the OAuth fields empty (Niravi doesn’t use OAuth yet). Always use a read-only key here.

Point it at a specific workspace (optional) — append &workspace=<id>. Your key defaults to its home workspace; account-scoped keys can target any workspace you belong to, or a demo:

https://mcp.niravi.io/?key=nv_YOUR_KEY&workspace=demo_newsroom

Step 2 · Option B — Local (Claude Desktop)

Claude Desktop → Settings → Developer → Edit Config, and add:

{
  "mcpServers": {
    "niravi": {
      "command": "npx",
      "args": ["-y", "@niravi/mcp"],
      "env": { "NIRAVI_API_KEY": "nv_YOUR_KEY_HERE" }
    }
  }
}

Save and restart Claude Desktop. (Requires Node.js; the @niravi/mcp package is fetched automatically by npx. To pin this release, use "@niravi/mcp@0.2.0".)

Try it

Ask Claude things like:

“Search my Niravi videos for a sunset over water.”
“What does video X say about pricing?”
“Summarize the speakers and topics in my latest upload.”

The tools (37 in `@niravi/mcp` 0.2.0, read-only)

Group	Tools
Search	`search` (`engine` and `moments_per_video` as on `/search`; `workspace_ids` searches several workspaces at once, hits merged into one ranked list and each tagged with its `workspace_id`), `magic_search` (character / location / music / emotion), `list_engines`
Chat & recall	`chat`, `recall_ask`, `recall_evidence` (answers carry `citations`)
Videos	`list_videos`, `get_video` (a summary with counts; `full: true` for everything), `frame`, `video_media`
Analysis	`transcript`, `scenes`, `shots`, `faces`, `characters`, `speakers`, `sounds`, `sound_events`, `audio_segments`, `music_tracks`, `get_regions`, `get_page`
People	`list_people`, `get_person`
Exports	`screenplay`, `storyboard`, `subtitles_srt`, `subtitles_vtt`
Flags & interrogation	`video_flags`, `video_interrogation`, `flags_feed`
Generation (read)	`niravo_stock_search`, `niravo_video_job`
Account	`list_workspaces` (what the key can reach), `me`, `health`, `get_index_options`

The remote connector serves 24 of these (no list_engines, frame, video_media, regions, pages, People, flags, interrogation, generation or index options) until it is updated. The .nmap download is a file, so it has no tool: use the SDKs or HTTP.

Every call is scoped to the workspaces your key can reach. Writes (upload/delete) are intentionally excluded.

Troubleshooting

No tools show up → check the URL has ?key=nv_… and the key is active (Settings → API access).
“No API key” in a tool result → the ?key= is missing or empty.
A search times out → rare; searches can be slow on a cold corpus. Retry.