Skip to main content
Version: 2.x.x

MCP and Skills

Use vsdk mcp and vsdk skills to set up your AI coding assistant for VideoSDK. vsdk mcp connects the assistant to the VideoSDK documentation through the MCP server, and vsdk skills installs the VideoSDK Agent Skill that teaches it how to build with the SDKs.

You do not need to sign in to VideoSDK to use either command.

Connect the MCP server​

Run vsdk mcp to see the setup for every supported assistant. This prints the configuration and changes nothing:

vsdk mcp

To see the setup for one assistant, name it with --client:

vsdk mcp --client cursor
Example output
Cursor
add to ~/.cursor/mcp.json
{
"mcpServers": {
"videosdk": {
"url": "https://docs.videosdk.live/mcp"
}
}
}

Apply it: vsdk mcp --client cursor --install

Apply the setup​

Add --install to let the CLI apply the setup for you. It requires --client.

vsdk mcp --client cursor --install

For Claude Code, the CLI runs the claude mcp add command. For every other assistant, it writes the videosdk server entry into the assistant's configuration file.

When the CLI writes a configuration file:

  • Your other servers and settings in the file are kept, including comments.
  • An existing videosdk entry is replaced as a whole.
  • Running the command again is safe. The CLI reports that the server is already there and leaves the file unchanged.

Restart your assistant after the setup is applied.

Supported assistants​

--clientAssistantWhat --install does
claude-codeClaude CodeRuns claude mcp add for your user
cursorCursorWrites ~/.cursor/mcp.json
vscodeVS CodeWrites .vscode/mcp.json in the current project
windsurfWindsurfWrites ~/.codeium/windsurf/mcp_config.json
antigravityAntigravityWrites ~/.gemini/config/mcp_config.json
codexCodex CLIWrites ~/.codex/config.toml
zedZedWrites ~/.config/zed/settings.json
clineClineWrites cline_mcp_settings.json in the VS Code user folder

Set up for one project​

By default, the setup applies to your user across every project. Add --project to set it up for the current project only:

vsdk mcp --client cursor --project --install

--project works with claude-code, cursor, vscode, and antigravity. The other assistants keep a single configuration for your user, so the CLI returns an error if you pass --project with them.

MCP options​

OptionShortDescription
--client <name>-cThe assistant to set up. See Supported assistants.
--install—Apply the setup instead of printing it. Requires --client.
--project-pSet up the current project only, for the assistants that support it.

For the manual setup of each assistant, see MCP Server.

Install the Agent Skill​

Run vsdk skills to install the VideoSDK Agent Skill. The CLI asks which assistants to install it into:

vsdk skills

To skip the questions, name the assistants with --agent and confirm with --yes:

vsdk skills --agent claude-code --yes

Separate several assistants with commas, for example --agent claude-code,cursor.

Restart your assistant after the installation.

info

vsdk skills downloads and runs the skills installer from npm, which fetches the skill from the videosdk-live/skills repository. It requires network access.

List the available skills​

Use --list to see the skills in the repository without installing anything:

vsdk skills --list
Example output

The description is shortened here.

Skills in https://github.com/videosdk-live/skills

videosdk
Use when the user wants to build anything with VideoSDK …

Install one: vsdk skills --skill videosdk

Skills options​

OptionShortDescription
--agent <names>-aAssistants to install into, separated by commas, or * for all. Asked when omitted.
--global-gInstall for your user instead of the current project.
--skill <name>—Install one skill from the repository, or * for all. Installs all when omitted.
--list-lShow the skills in the repository without installing.

For more about the skill itself, see Agent Skill.

Use in scripts​

Both commands accept --json, which returns a single JSON object on stdout.

vsdk mcp --client cursor --install --json
vsdk skills --list --json

Without a terminal, vsdk skills cannot ask which assistants to install into. Pass both --agent and --yes, otherwise the command exits with code 1:

vsdk skills --agent claude-code --yes --json

See Global options for the options shared by every command, and Errors and exit codes for what each exit code means.

Get help​

To view the available options for each command:

vsdk mcp --help
vsdk skills --help

Got a Question? Ask us on discord