{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2n4dhw6t3m7w","handle":"iflow-mcp-piebro-vlc-mcp-server","url":"https://wellknown.network/agents/iflow-mcp-piebro-vlc-mcp-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-piebro-vlc-mcp-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-piebro-vlc-mcp-server","markdown":"https://wellknown.network/agents/iflow-mcp-piebro-vlc-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-piebro-vlc-mcp-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-piebro-vlc-mcp-server/status","claim":"https://wellknown.network/agents/iflow-mcp-piebro-vlc-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-piebro-vlc-mcp-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-piebro-vlc-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:iflow-mcp-piebro-vlc-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_piebro_vlc-mcp-server","summary":"An MCP (Model Contex Protocol) Server to play and control movies using VLC.","description":"# VLC MCP Server\n\nAn MCP (Model Context Protocol) Server to play and control movies using the VLC media player.\nUse any MCP client to control play videos remotely (e.g. [awesome-mcp-clients](https://github.com/punkpeye/awesome-mcp-clients))\n\nI use my [signal-mcp-client](https://github.com/piebro/signal-mcp-client) running on an old laptop connected to my beamer.\nThis way I can play a movie by sending a signal message.\nAn example of how to use it is shown in the screenshot below.\n\n<p align=\"center\">\n<img src=\"https://raw.githubusercontent.com/piebro/vlc-mcp-server/main/assets/vlc_chat_screenshot.png\" width=\"40%\" style=\"padding: 1% 1% 1% 1%\">\n</p>\n\n## Usage\n\nThis installation is for Linux systems running Ubuntu or a similar Debian-based system like Raspberry Pi OS.\nWith a few modifications it should also work on other systems.\nFeel free to create a pull request if you get it working on another system.\n\n1. Install VLC, mediainfo and uv.\n    ```bash\n    sudo apt-get install vlc mediainfo\n    curl -LsSf https://astral.sh/uv/install.sh | sh\n    ```\n\n2. Start the VLC http server:\n    ```bash\n    export DISPLAY=:0 # needed when running it remotely on a server\n    vlc --extraintf=http --http-host=localhost --http-port=8081 --http-password=your_password\n    ```\n3. Add the server to the MCP config file of your client (like [signal-mcp-client](https://github.com/piebro/signal-mcp-client) or [awesome-mcp-clients](https://github.com/punkpeye/awesome-mcp-clients))\n    ```json\n    {\n        \"name\": \"vlc-mcp-server\",\n        \"command\": \"uvx\",\n        \"args\": [\n            \"vlc-mcp-server\"\n        ],\n        \"env\": {\n            \"ROOT_VIDEO_FOLDER\": \"path/to/your/video/folder\",\n            \"VLC_HTTP_HOST\": \"localhost\",\n            \"VLC_HTTP_PORT\": \"8081\",\n            \"VLC_HTTP_PASSWORD\": \"your_password\"\n        }\n    }\n    ```\n\n    or clone the repo and use `uv` with a directory:\n\n    ```json\n    {\n        \"name\": \"vlc-mcp-server\",\n        \"command\": \"uv\",\n        \"args\": [\n        …","publisher":null,"homepage":"https://github.com/piebro/vlc-mcp-server","repository":"https://github.com/piebro/vlc-mcp-server/issues","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp","server","vlc"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_piebro_vlc-mcp-server","type":"package_pypi","auth":null,"probeable":false},{"url":"pypi:vlc-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.848,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_piebro_vlc-mcp-server","registry":"pypi","observedAt":"2026-09-10T15:25:15.514Z","publishedAt":"2026-01-07T01:19:15.387279Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_piebro_vlc-mcp-server","url":"https://pypi.org/project/iflow-mcp_piebro_vlc-mcp-server/","firstSeenAt":"2026-09-09T20:25:04.613Z","fetchedAt":"2026-09-09T20:25:04.613Z","normalizedAt":"2026-09-09T20:25:04.613Z"},{"source":"pypi","key":"vlc-mcp-server","url":"https://pypi.org/project/vlc-mcp-server/","firstSeenAt":"2026-09-10T15:23:46.779Z","fetchedAt":"2026-09-10T15:23:46.779Z","normalizedAt":"2026-09-10T15:23:46.779Z"}]},"firstSeenAt":"2026-09-09T20:25:04.613Z","updatedAt":"2026-09-10T15:25:15.514Z"}