# Sonpiaz MCP Server (MCP server)

> Sonpiaz MCP Server is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Hand any social video to your AI agent — frames + transcript bundled. It has 253 GitHub stars, is released under the MIT license and runs locally with npx -y @sonpiaz/watch-cli-mcp.

MCP (Model Context Protocol) stdio server that exposes watch-cli as a callable tool. Watch any social video → get an architecture diagram, working component, runnable notebook, or step-by-step cheat sheet — automatically.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/sonpiaz/watch-cli |
| GitHub stars | 253 |
| License | MIT |
| Language | Shell |
| Transport | stdio |
| Packages | npm: @sonpiaz/watch-cli-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | AI & search |
| Latest release | v0.3.4 (Sep 4, 2026) |
| Last commit | Sep 13, 2026 |
| MCP registry name | io.github.sonpiaz/watch-cli |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sonpiaz-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@sonpiaz/watch-cli-mcp"
      ],
      "env": {
        "KYMA_API_KEY": "your-value",
        "GROQ_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env KYMA_API_KEY=your-value --env GROQ_API_KEY=your-value --transport stdio sonpiaz-mcp-server -- npx -y @sonpiaz/watch-cli-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sonpiaz-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sonpiaz/watch-cli-mcp"
      ],
      "env": {
        "KYMA_API_KEY": "your-value",
        "GROQ_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "kyma_api_key",
      "description": "KYMA_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "groq_api_key",
      "description": "GROQ_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "sonpiaz-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sonpiaz/watch-cli-mcp"
      ],
      "env": {
        "KYMA_API_KEY": "${input:kyma_api_key}",
        "GROQ_API_KEY": "${input:groq_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `KYMA_API_KEY` (secret): Kyma API key (default backend). Get one at https://kymaapi.com — first $0.50 free, then pay-per-use (~$0.05 per 1-hour video). Optional if…
- `GROQ_API_KEY` (secret): Groq API key for direct BYOK transcription (alternative to Kyma). Set this instead of KYMAAPIKEY if you prefer direct provider.
- `WATCH_AUDIO_MODE`: Backend routing override. Values: kyma (default), byok (use GROQAPIKEY), local (whisper.cpp on $PATH, fully offline).

## Similar MCP servers

- [Context7](https://appsgit.com/mcp-servers/context7): Up-to-date code docs for any prompt. (62,752 stars, MIT, needs API key)
- [FunASR](https://appsgit.com/mcp-servers/funasr): Transcribe local audio with FunASR and SenseVoice using private, on-device inference. (20,596 stars, MIT)
- [Bifrost](https://appsgit.com/mcp-servers/bifrost): Fastest enterprise AI gateway (50x faster than LiteLLM) with adaptive load balancer, cluster mode, guardrails, 1000+ models support & <100 µs overhead at 5k RPS. (8,591 stars, Apache-2.0)
- [Honcho](https://appsgit.com/mcp-servers/honcho): Memory that reasons: continual learning for stateful agents. (7,494 stars, AGPL-3.0, needs API key)
- [Semble](https://appsgit.com/mcp-servers/semble): Fast and Accurate Code Search for Agents. (6,185 stars, MIT)
- [Exa](https://appsgit.com/mcp-servers/exa): Connect AI agents to Exa for web search, content fetching, and multi-step research. (5,088 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/sonpiaz-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.