@wecandeo/mcp-videopack-v4
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@wecandeo/mcp-videopack-v4 Upload the video from /Users/me/Downloads/promo.mp4"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Wecandeo VideoPack v4 MCP Server
Wecandeo VideoPack v4 API를 위한 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Claude Code, Cursor 등 MCP 클라이언트에서 위캔디오 비디오팩 전반 기능(업로드 · 인코딩 · 배포 · 미디어 보관함)을 Stdio 모드로 사용할 수 있습니다.
홈페이지: https://www.wecandeo.com
API 가이드: https://support.wecandeo.com/v4.0
위캔디오 비디오팩 MCP는 기능별로 세 개의 서버로 구성됩니다.
@wecandeo/mcp-videopack-v4— 비디오팩 전반 기능 (본 서버)
@wecandeo/mcp-analytics-v4— 통계
@wecandeo/mcp-ai-v4— AI 기능
설치 및 실행
환경 변수
변수 | 설명 |
| Wecandeo API 키 (필수) |
API 키 확인 방법: 비디오팩 API 시작하기 가이드를 참고하세요.
npx로 실행 (권장)
WECANDEO_API_KEY=your_key npx @wecandeo/mcp-videopack-v4Claude Desktop / Cursor 설정
claude_desktop_config.json 또는 .cursor/mcp.json:
{
"mcpServers": {
"wecandeo-v4": {
"command": "npx",
"args": ["-y", "@wecandeo/mcp-videopack-v4"],
"env": {
"WECANDEO_API_KEY": "your_api_key_here"
}
}
}
}Claude Code 설정
~/.claude.json (글로벌) 또는 프로젝트 .mcp.json:
{
"mcpServers": {
"wecandeo-v4": {
"command": "npx",
"args": ["@wecandeo/mcp-videopack-v4"],
"env": {
"WECANDEO_API_KEY": "your_api_key_here"
}
}
}
}소스에서 직접 실행
npm install && npm run build
WECANDEO_API_KEY=your_key node dist/index.jsRelated MCP server: ken-api-mcp
파일 업로드 (로컬 파일 + URL 지원)
wecandeo_upload_video, wecandeo_upload_thumbnail, wecandeo_upload_caption 의 source 인자는
로컬 파일 경로(예: /Users/me/clip.mp4, ./caption.vtt)와 원격 URL(http(s)://...)을 모두 지원합니다.
로컬 경로인 경우 파일을 직접 읽어 업로드하고, URL인 경우 다운로드 후 업로드합니다.
업로드 흐름:
wecandeo_upload_create_token으로 토큰과 업로드 URL들을 발급받습니다. (토큰 1개당 파일 1개)wecandeo_upload_video로 동영상을 업로드합니다.wecandeo_upload_video_status/wecandeo_upload_video_progress로 진행 상태를 확인합니다.(선택)
wecandeo_upload_thumbnail,wecandeo_upload_caption으로 썸네일/자막을 추가합니다.
제공 도구
그룹 | 도구 | 설명 |
Upload |
| 업로드 토큰 발급 (V4) |
| 동영상 업로드 (로컬 파일/URL) | |
| 업로드 상태 조회 | |
| 업로드 진행률 조회 | |
| 인코딩 상태 조회 | |
| 썸네일 업로드 (로컬 파일/URL) | |
| 자막(WebVTT) 업로드 (로컬 파일/URL) | |
| 자막 언어 코드 목록 | |
Video Retrieve |
| 패키지별 동영상 목록 |
| 폴더별 동영상 목록 | |
| 동영상 상세 (legacy) | |
| 동영상 상세 (v4, AI 요약 포함) | |
| 배포 코드 조회 | |
| 인코딩 파일 목록 | |
| 원타임 키 발급 | |
| 썸네일 이미지 조회 | |
| 자막 파일 조회 | |
Video Update |
| 패키지에 추가 |
| 패키지에서 제외 | |
| 배포 시작 | |
| 배포 중지 | |
| 보관함 폴더 이동 | |
| 메타데이터 수정 | |
| 대표 썸네일 설정 | |
Package |
| 배포 패키지 목록 |
Archive |
| 동영상 폴더 생성 |
| 동영상 폴더 목록 | |
| 폴더명으로 조회 | |
| 원본 다운로드 URL 조회 | |
(공통) |
| 서버 응답 확인 |
API 호스트 참고
레거시 엔드포인트:
https://api.wecandeo.com(인증:key쿼리 파라미터)v4 네이티브 엔드포인트:
https://api.v4.wecandeo.com(인증:x-api-key헤더) —wecandeo_video_details_v4,wecandeo_archive_original_download_url
Available Tools
29 toolspingA
Check if the Wecandeo VideoPack v4 MCP server is responsive
Inputs: no named parameters.
wecandeo_archive_create_folderA
Create a new video folder in the media archive. Returns the new folder ID.
Inputs: folderName (required).
wecandeo_archive_folder_by_nameC
Look up a media-archive video folder by its name.
Inputs: folderName (required).
wecandeo_archive_list_foldersB
Retrieve the list of video folders in the media archive.
Inputs: no named parameters.
wecandeo_archive_original_download_urlA
Get the download URL of the original video in the media archive. The URL is valid for 2 days.
Inputs: accessKey (required).
wecandeo_package_listA
Retrieve the list of distribution packages (packageId, packageType, packageName, sharing flags).
Inputs: no named parameters.
wecandeo_upload_captionA
Upload a WebVTT (.vtt) caption file for a video. Issues a caption upload token for the accessKey then uploads. source can be a local file path or a remote URL.
Inputs: source (required), accessKey (required), langId, captionType.
wecandeo_upload_caption_languageA
Retrieve the list of supported caption languages and their langId codes.
Inputs: no named parameters.
wecandeo_upload_create_tokenA
Create a V4 video upload token. Returns { ver, uploadUrl, token }. A token uploads exactly one file and is valid for 60 minutes.
Inputs: no named parameters.
wecandeo_upload_thumbnailA
Upload a thumbnail image for a video. Issues a thumbnail upload token for the accessKey then uploads. source can be a local file path or a remote URL.
Inputs: source (required), accessKey (required).
wecandeo_upload_videoB
Upload a video file using a V4 upload token. source can be a local filesystem path or a remote http(s) URL.
Inputs: token (required), source (required), folderId (required), uploadUrl (required), +13 more.
wecandeo_upload_video_progressA
Check the upload progress of a video by token. Returns process (0-100%) and transferred byte counters.
Inputs: token (required).
wecandeo_upload_video_statusA
Check the upload status of a video by token. Returns a status such as UPLOADING, UPLOADED, THUMBS, DEPLOY, COMPLETE, U_ERROR, FILEOVER.
Inputs: token (required).
wecandeo_video_add_to_packageB
Add a video to a distribution package (triggers encoding / URL issuance).
Inputs: accessKey (required), packageId (required).
wecandeo_video_captionB
Retrieve the caption files of a video.
Inputs: accessKey (required).
wecandeo_video_detailsB
Get detailed information of a video. Returns camelCase fields and AI summaries when available.
Inputs: accessKey (required), packageId (required).
wecandeo_video_encoded_fileB
Retrieve the list of encoded files (profiles) for a video.
Inputs: accessKey (required), packageId (required).
wecandeo_video_encoding_statusB
Check the encoding status of an uploaded video. Returns per-profile process (0-100) and status.
Inputs: accessKey (required), packageId (required).
wecandeo_video_exclude_from_packageB
Exclude a video from a distribution package.
Inputs: accessKey (required), packageId (required).
wecandeo_video_list_folderC
Retrieve the list of videos in a media-archive folder. Supports search, sort and pagination.
Inputs: folderId (required), page, keyword, pageSize, +3 more.
wecandeo_video_list_packageB
Retrieve the list of videos in a distribution package. Supports search, sort and pagination.
Inputs: packageId (required), page, keyword, folderId, +4 more.
wecandeo_video_modify_folderB
Move a video to a different media-archive folder.
Inputs: folderId (required), accessKey (required).
wecandeo_video_modify_metaC
Modify the metadata (title, series, author, copyright, rate, content, etc, tag) of a video.
Inputs: accessKey (required), etc, tag, rate, +5 more.
wecandeo_video_onetime_keyA
Generate a time-limited one-time access key for a video key (Level 2) or file key (Level 3).
Inputs: key (required), expire.
wecandeo_video_pause_publishB
Pause publishing (distributing) a video within a package.
Inputs: accessKey (required), packageId (required).
wecandeo_video_pub_codeB
Get the distribution codes (video URL, play URL, per-file URLs) of a video in a package.
Inputs: accessKey (required), packageId (required).
wecandeo_video_set_default_thumbnailB
Set a specific extracted thumbnail (by sequence) as the video's default thumbnail.
Inputs: seq (required), accessKey (required).
wecandeo_video_start_publishC
Start publishing (distributing) a video within a package.
Inputs: accessKey (required), packageId (required).
wecandeo_video_thumbnailA
Retrieve the thumbnail images (extracted frames, multiple sizes) of a video.
Inputs: accessKey (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Each tool targets a distinct action and resource (upload, status, progress, captions, thumbnails, distribution, archive). Even similar tools like upload_video_status and upload_video_progress are clearly differentiated by their return values.
All tools follow the consistent pattern 'wecandeo_verb_noun' (e.g., wecandeo_upload_create_token, wecandeo_video_details). The only exception is 'ping', but it is a standard health check tool.
29 tools is above the typical well-scoped range but justified given the breadth of video management features (upload, encoding, captions, distribution, archive). A few tools could potentially be combined (e.g., status and progress) but overall the count is reasonable.
The toolset covers core workflows (upload, encode, distribute, metadata) but lacks delete operations for videos, captions, and thumbnails. This is a notable gap that could cause dead ends during agent-driven tasks.
Related MCP Connectors
Generate, edit, and render videos via the Shotstack video editing API.
Create and edit videos, images, voiceovers, music, and avatars with the VideoGen API.
Manage videos and live streams, inspect captions, players and webhooks, and read play analytics.
AI video generation via the Vivideo API: auto or manual mode, avatars, voices, brand kits.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables programmatic video generation via the json2video API, supporting scene and element creation, status polling, and template management.527MIT
- AlicenseNot gradedqualityCmaintenanceProvides LLMs with full access to the Ken Video API for professional video processing, including adding audio, captions, and job management.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage videos on PlayVideo, including collections, videos, webhooks, embed settings, API keys, and account management.4 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage Vimeo video libraries through natural language, including bulk folder operations, transcripts, chapters, captions, showcases, tags, privacy, and embed presets.4322 npmMIT