VLC MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VLC_BASE_URL | No | VLC HTTP interface URL. Default: http://127.0.0.1:8080. | http://127.0.0.1:8080 |
| MCP_HTTP_PORT | No | Port for local HTTP mode. Default: 3000. | 3000 |
| MCP_TRANSPORT | No | MCP transport: stdio or local http. Default: stdio. | stdio |
| VLC_HTTP_PASSWORD | No | Password set for VLC's HTTP/Lua interface. Default: empty. | |
| VLC_HTTP_USERNAME | No | Username for VLC's HTTP/Lua interface. Default: empty. | |
| VLC_HTTP_TIMEOUT_MS | No | Request timeout, from 100 to 120000 milliseconds. Default: 5000. | 5000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| vlc_get_statusA | Get VLC playback state, current media, elapsed time, duration, and volume. |
| vlc_list_playlistA | List media items currently in the VLC playlist. |
| vlc_playA | Start or resume VLC playback. Optionally play a playlist item by its numeric ID. |
| vlc_pauseA | Toggle VLC playback between paused and playing. |
| vlc_stopB | Stop VLC playback. |
| vlc_nextA | Skip to the next item in the VLC playlist. |
| vlc_previousA | Return to the previous item in the VLC playlist. |
| vlc_set_volumeB | Set VLC volume. VLC accepts values from 0 (muted) to 512 (maximum). |
| vlc_seekA | Seek to a position in the currently playing media. |
| vlc_add_mediaA | Add media to the VLC playlist. Accepts a local path or media URL supported by VLC. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool maps to a distinct playback or playlist operation. The only minor overlap is vlc_play and vlc_pause, since pause toggles playback and play resumes from pause, but descriptions make the intended difference clear.
All tools use a consistent snake_case vlc_ prefix followed by a clear action or action_resource name. The pattern is predictable throughout.
Ten tools is well-scoped for VLC playback control, with each tool covering a specific operation. There is no obvious filler.
Core playback controls, status, volume, seeking, and adding media are covered. Playlist management is slightly incomplete because there is no remove-item or clear-playlist operation.