Valmera

https://github.com/abo3skralmasaoodi/valmera-mcp
Admin
Valmera is a hosted AI video editor for footage you already recorded, available through a Model...
Tokens:62,139
Snippets:400
Trust Score:7.5
License:MIT
Update:2 days ago
Show doc for...
Tokens:
Raw
### Install Valmera plugin in Claude Code

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Adds the Valmera MCP marketplace and installs the plugin in Claude Code. Run these commands in sequence.

```sh
/plugin marketplace add ABO3SKRALMASAOODI/valmera-mcp
/plugin install valmera@valmera
```

--------------------------------

### Install editing skill with Skills CLI

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Installs the edit-video-with-valmera skill into the current project using the pinned Skills CLI. Requires Node.js 22.20 or later. Use -a claude-code or -a cursor for those clients.

```sh
npx skills@1.7.6 add ABO3SKRALMASAOODI/valmera-mcp@v1.0.1 --skill edit-video-with-valmera -a codex
```

--------------------------------

### Install Valmera Antigravity Plugin via CLI

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/plugins/antigravity/README.md

Clones the pinned plugin release and installs it using the Antigravity CLI. Run `agy plugin validate --strict` before installation to check the package, then verify with `agy plugin list --json`.

```sh
git clone --branch antigravity-v1.0.0 --depth 1 https://github.com/ABO3SKRALMASAOODI/valmera-mcp.git valmera-antigravity
agy plugin validate --strict ./valmera-antigravity/plugins/antigravity
agy plugin install ./valmera-antigravity/plugins/antigravity
agy plugin list --json
```

--------------------------------

### Prompt to Start an Edit with Valmera

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/plugins/antigravity/README.md

Example prompt for editing a recording via conversation. Specify the target platform, aspect ratio, content order, and constraints like captions and music. Confirm source and cost expectations before starting.

```text
Use Valmera on the uploaded recording I select.
Make a 45-second product update for LinkedIn in 16:9.
Keep the problem, the demonstration and its result in that order.
Remove waiting time and false starts. Keep interface labels readable.
Add accurate captions, keep my voice and do not add music.
Confirm the source and editing cost expectations before starting.
Show a preview; export the version I approve as an MP4.
```

--------------------------------

### Install Valmera plugin in Claude Code

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLAUDE-PLUGIN.md

Adds Valmera's repository marketplace and installs the plugin inside a Claude Code session. After installation, open /mcp and authenticate the Valmera connection.

```text
/plugin marketplace add ABO3SKRALMASAOODI/valmera-mcp
/plugin install valmera@valmera
```

--------------------------------

### Add Valmera marketplace and list available plugins

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/plugins/openai/README.md

Adds the Valmera repository as a marketplace for supported Codex clients and lists available plugins. The `--ref main` reference follows repository updates; review changes before upgrading your installed marketplace.

```sh
codex plugin marketplace add ABO3SKRALMASAOODI/valmera-mcp --ref main
codex plugin list --marketplace valmera --available --json
```

--------------------------------

### keep_segments, set_frame, and render_preview calls

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/MCP-RECORDED-EDIT.md

Three separate tool calls for editing a project: keep_segments selects source ranges, set_frame applies a centered square crop, and render_preview generates an approval-quality preview. The project_id 5532 is a recorded example, not reusable; create your own project and use its ID.

```json
{"tool":"keep_segments","arguments":{"project_id":5532,"segments":[[3,7],[12,16],[19,23]],"snap_to_words":false}}
```

```json
{"tool":"set_frame","arguments":{"project_id":5532,"ratio":"1:1","mode":"crop","focus_x":0.5,"focus_y":0.5}}
```

```json
{"tool":"render_preview","arguments":{"project_id":5532,"complete":true,"quality":"approval","report":true}}
```

--------------------------------

### Cline MCP settings for Valmera (streamableHttp)

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/llms-install.md

Configure the Valmera remote MCP server in Cline's cline_mcp_settings.json. Uses streamableHttp transport and a bearer token in the Authorization header. Never commit the token to a file.

```json
{
  "mcpServers": {
    "valmera": {
      "type": "streamableHttp",
      "url": "https://valmera.io/mcp/server",
      "headers": { "Authorization": "Bearer <your-valmera-token>" },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

--------------------------------

### Configure Valmera MCP server in Continue

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLIENTS.md

Adds the Valmera MCP server to Continue with streamable HTTP transport and optional authorization header.

```yaml
mcpServers:
  - name: valmera
    type: streamable-http
    url: https://valmera.io/mcp/server
    requestOptions:
      headers:
        Authorization: Bearer <your-valmera-token>
```

--------------------------------

### Read linked public metadata with curl

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CONNECTION-TROUBLESHOOTING.md

Run in a terminal with curl. No token needed. Uses time limits. For Valmera, confirm that the resource is https://valmera.io/mcp/server, that authorization_servers includes https://valmera.io, and that the authorization metadata's issuer matches that URL. The metadata advertises the authorization and token endpoints and PKCE S256. Reading it does not complete those flows.

```sh
curl -sS --connect-timeout 10 --max-time 20 \
  -D - https://valmera.io/.well-known/oauth-protected-resource

curl -sS --connect-timeout 10 --max-time 20 \
  -D - https://valmera.io/.well-known/oauth-authorization-server
```

--------------------------------

### Inspect public server card with curl

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CONNECTION-TROUBLESHOOTING.md

Run in a terminal with curl. No token needed. Uses time limits. Directories can inspect the public server card for the endpoint, authentication information and published tool definitions without accessing a creator's account. The card is Valmera's public description. Your authenticated client's current tools/list establishes which tools are actually exposed to that connection. Neither a successful card request nor a public tool definition proves that a render or export succeeds.

```sh
curl -sS --connect-timeout 10 --max-time 20 \
  -D - https://valmera.io/.well-known/mcp/server-card.json
```

--------------------------------

### Add Valmera MCP server via Codex CLI

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Use these commands to add and log in to the Valmera MCP server in Codex CLI. Alternatively, add `[mcp_servers.valmera]` with `url = "https://valmera.io/mcp/server"` to `~/.codex/config.toml`.

```sh
codex mcp add valmera --url https://valmera.io/mcp/server
codex mcp login valmera
```

--------------------------------

### Any stdio-only client MCP configuration for Valmera

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Use this JSON configuration for stdio-only clients that cannot use HTTP directly. It uses `npx` with `mcp-remote` to connect to the Valmera MCP server.

```json
{
  "mcpServers": {
    "valmera": { "command": "npx", "args": ["-y", "mcp-remote", "https://valmera.io/mcp/server"] }
  }
}
```

--------------------------------

### Cursor MCP configuration for Valmera

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Add this JSON to `~/.cursor/mcp.json` to configure the Valmera MCP server in Cursor.

```json
{
  "mcpServers": {
    "valmera": { "url": "https://valmera.io/mcp/server" }
  }
}
```

--------------------------------

### Inspect downloaded export with ffprobe, ffmpeg, and shasum

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/MCP-RECORDED-EDIT.md

Commands to inspect the downloaded final MP4: ffprobe shows stream and format details, ffmpeg computes audio statistics, and shasum verifies file hashes. Audio statistics establish silence but do not test speech or music preservation.

```sh
ffprobe -v error -count_frames \
  -show_entries stream=codec_name,codec_type,width,height,r_frame_rate,nb_read_frames,duration \
  -show_entries format=duration,size -of json revised-final.mp4

ffmpeg -i revised-final.mp4 -map 0:a \
  -af astats=metadata=0:reset=0 -vn -f null -

shasum -a 256 original-source.mp4 first-preview.mp4 revised-final.mp4
```

--------------------------------

### Add Valmera MCP server via Gemini CLI

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Use this command to add the Valmera MCP server to Gemini CLI over HTTP. After running, open Gemini CLI, run `/mcp auth valmera` and sign in.

```sh
gemini mcp add --transport http valmera https://valmera.io/mcp/server
```

--------------------------------

### Configure Valmera MCP server in Goose

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLIENTS.md

Adds the Valmera MCP server to Goose with streamable HTTP transport, a 60-second timeout, and a description.

```yaml
extensions:
  valmera:
    enabled: true
    type: streamable_http
    name: valmera
    description: Agentic video editor
    uri: https://valmera.io/mcp/server
    timeout: 60
```

--------------------------------

### Configure Valmera MCP server in Zed

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLIENTS.md

Adds the Valmera MCP server to Zed's context servers configuration.

```json
{
  "context_servers": {
    "valmera": { "url": "https://valmera.io/mcp/server" }
  }
}
```

--------------------------------

### Run MCP Inspector with HTTP transport

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLIENTS.md

Use this command to test the Valmera MCP server via the MCP Inspector. If the Inspector connects and lists the tools, the server is fine and any problem is in the other client's configuration.

```sh
npx @modelcontextprotocol/inspector --server-url https://valmera.io/mcp/server --transport http
```

--------------------------------

### Windsurf MCP configuration for Valmera

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Add this JSON to `~/.codeium/windsurf/mcp_config.json` to configure the Valmera MCP server in Windsurf.

```json
{
  "mcpServers": {
    "valmera": { "serverUrl": "https://valmera.io/mcp/server" }
  }
}
```

--------------------------------

### VS Code MCP configuration for Valmera

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Add this JSON to `.vscode/mcp.json` to configure the Valmera MCP server in VS Code (GitHub Copilot agent mode).

```json
{
  "servers": {
    "valmera": { "type": "http", "url": "https://valmera.io/mcp/server" }
  }
}
```

--------------------------------

### Validate and Build Claude Plugin Package

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/PUBLISHING.md

Validates the plugin manifest and builds the standalone Claude upload package. The builder refuses an existing output path and includes only eight explicit files. It prints the archive's SHA-256.

```sh
claude plugin validate .claude-plugin/plugin.json
python3 scripts/build-claude-plugin.py /tmp/valmera-claude-1.0.2.zip
```

--------------------------------

### Add Valmera MCP server via Claude Code CLI

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/README.md

Use this command to add the Valmera MCP server to Claude Code over HTTP. After running, execute `/mcp` inside Claude Code and choose Authenticate.

```sh
claude mcp add --transport http valmera https://valmera.io/mcp/server
```

--------------------------------

### Inspect anonymous response headers with curl

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CONNECTION-TROUBLESHOOTING.md

Run in a terminal with curl. No token needed. Uses time limits so an unavailable endpoint does not leave the check running indefinitely. The observed authorization challenge is HTTP/2 401 with WWW-Authenticate: Bearer realm="valmera", resource_metadata="https://valmera.io/.well-known/oauth-protected-resource". Header capitalization and HTTP version can differ; check the status and metadata URL, not their formatting.

```sh
curl -sS --connect-timeout 10 --max-time 20 \
  -D - -o /dev/null https://valmera.io/mcp/server
```

--------------------------------

### Configure Valmera MCP server in LibreChat

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLIENTS.md

Adds the Valmera MCP server to LibreChat with streamable HTTP transport and OAuth endpoints for authorization.

```yaml
mcpServers:
  valmera:
    type: streamable-http
    url: https://valmera.io/mcp/server
    oauth:
      authorization_url: https://valmera.io/mcp/oauth/authorize
      token_url: https://valmera.io/mcp/oauth/token
      redirect_uri: http://localhost:3080/api/mcp/valmera/oauth/callback
```

--------------------------------

### Add Valmera MCP server to Claude Code

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLIENTS.md

Registers the Valmera MCP server over HTTP with Claude Code. After adding, run /mcp inside Claude Code; `claude mcp list` should show `✔ Connected`. Add `--scope user` to make it available in every repository, or `--scope project` to write a shared `.mcp.json`.

```sh
claude mcp add --transport http valmera https://valmera.io/mcp/server
# then inside Claude Code:
/mcp
```

--------------------------------

### Configure stdio bridge with mcp-remote

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLIENTS.md

JSON configuration for an MCP client to connect to Valmera via a stdio bridge using mcp-remote. mcp-remote runs the OAuth flow in your browser for you.

```json
{
  "mcpServers": {
    "valmera": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://valmera.io/mcp/server"]
    }
  }
}
```

--------------------------------

### Inspect exported MP4 with ffprobe

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/EDITOR-EVALUATION.md

Use ffprobe to report actual streams and duration of the exported MP4. The output includes codec type/name, dimensions, frame rate, duration, and size in JSON format. This is a technical check only; full playback and source comparison are still required.

```sh
ffprobe -v error -show_entries stream=codec_type,codec_name,width,height,r_frame_rate -show_entries format=duration,size -of json revised-export.mp4
```

--------------------------------

### Configure Valmera MCP server in Cline

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLIENTS.md

Adds the Valmera MCP server to Cline with streamable HTTP transport, optional authorization header, and auto-approve disabled by default.

```json
{
  "mcpServers": {
    "valmera": {
      "type": "streamableHttp",
      "url": "https://valmera.io/mcp/server",
      "headers": { "Authorization": "Bearer <your-valmera-token>" },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

--------------------------------

### First-edit brief for Valmera video editing

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/CLAUDE-PLUGIN.md

Use this prompt to request a first edit in Valmera. It specifies a 45-second vertical video with readable captions, preserving the speaker's meaning and names, confirming project and cost before billable work, and waiting for approval before export.

```text
Use Valmera to edit the recording I select. Make a 45-second vertical video
with readable captions. Preserve the speaker's meaning and keep names accurate.
Confirm the project and cost expectations before billable work. Show me the
rendered preview, explain what changed, and wait for approval before export.
```

--------------------------------

### Cut range 12–16 from source in project 5532

Source: https://github.com/abo3skralmasaoodi/valmera-mcp/blob/main/docs/MCP-RECORDED-EDIT.md

Local source-time cut that removes source 12–16 from the middle section, leaving 3–7 and 19–23. The EDL changed from v3 to v4.

```json
{"tool":"cut_range","arguments":{"project_id":5532,"start":14,"end":16,"snap_to_words":false}}
```
Tokens:
Raw