MCP Configuration

All clients connect to the same server URL and authenticate with a Videoslash API key (vsl_...).

https://www.videoslash.com/api/mcp

Store your key in an environment variable instead of committing it to config files.

export VIDSLASH_API_KEY=vsl_your_key_here

Claude Code

Add a remote HTTP server with a Bearer header:

claude mcp add --transport http videoslash https://www.videoslash.com/api/mcp \
  --header "Authorization: Bearer $VIDSLASH_API_KEY"

Verify the connection with /mcp inside Claude Code. The server should show as connected with the tools your key's scopes allow.

JSON config alternative

Add to ~/.claude.json or a project .mcp.json:

{
  "mcpServers": {
    "videoslash": {
      "type": "http",
      "url": "https://www.videoslash.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${VIDSLASH_API_KEY}"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "videoslash": {
      "url": "https://www.videoslash.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VIDSLASH_API_KEY}"
      }
    }
  }
}

Restart Cursor or reload MCP servers from Settings → Tools & MCP.

Codex CLI

Add a streamable HTTP server using an environment variable for the token:

codex mcp add videoslash --url https://www.videoslash.com/api/mcp \
  --bearer-token-env-var VIDSLASH_API_KEY

Inspect the saved config with codex mcp get videoslash.

OpenCode

Add to opencode.json:

{
  "mcp": {
    "videoslash": {
      "type": "remote",
      "url": "https://www.videoslash.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${VIDSLASH_API_KEY}"
      }
    }
  }
}

Or via CLI:

opencode mcp add videoslash --url https://www.videoslash.com/api/mcp \
  --header "Authorization=Bearer $VIDSLASH_API_KEY"

Required scopes

Goal	Scopes needed
Check account and credits	`read` (included on every key)
Browse Creative Studio models	`read`
Generate titles and scripts	`scripts:generate`
Generate images and videos	`creative:generate`

Create keys in Account settings. Enable the write toggles for script and Creative Studio access.

Troubleshooting

Symptom	Fix
Connection fails or MCP client refuses redirect	Use `https://www.videoslash.com/api/mcp` (with `www`). The apex domain (`videoslash.com`) may redirect to HTTP on `www`, which MCP clients block.
401 Unauthorized	Key missing, revoked, or expired. Create a new key.
Fewer tools than expected	Key lacks write scopes. Create a key with Allow script generation or Allow Creative Studio generation.
Tool returns `insufficient_credits`	Top up credits in the dashboard.
Local file input fails	MCP cannot upload bytes. Use `request_creative_media_upload`, `curl -T`, then `mediaUploads`.

MCP Configuration

On this page