capped-video-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FAL_KEY | No | fal API key (API scope; do not use ADMIN scope). | |
| CAPPED_VIDEO_HOME | No | Data folder location; absolute path, only via registration env (not effective in .env). Example: D:/capped-video. | |
| CAPPED_VIDEO_FFMPEG | No | Path to ffmpeg for previews; empty uses PATH (preview.ffmpeg). Example: C:/ffmpeg/bin/ffmpeg.exe. | |
| REPLICATE_API_TOKEN | No | Replicate API token. | |
| CAPPED_VIDEO_FAILOVER | No | Switch to fallback_model on confirmed rejection (limits.failover). Example: true. | |
| CAPPED_VIDEO_PROVIDER | No | Set to 'mock' to avoid real API calls; other values are errors. Example: mock. | |
| CAPPED_VIDEO_OUTPUT_DIR | No | Directory to save videos; relative paths are relative to the data folder (download.dir). Example: ~/Videos/capped-video. | |
| CAPPED_VIDEO_DAILY_MAX_USD | No | Daily maximum budget in USD (limits.daily_max_usd). Example: 5. | |
| CAPPED_VIDEO_DEFAULT_MODEL | No | Default model (defaults.model). Example: kling-3.0. | |
| CAPPED_VIDEO_MAX_RESOLUTION | No | Maximum allowed resolution (limits.max_resolution). Example: 720p. | |
| CAPPED_VIDEO_DAILY_MAX_COUNT | No | Daily maximum job count (limits.daily_max_count). Example: 10. | |
| CAPPED_VIDEO_MONTHLY_MAX_USD | No | Monthly maximum budget in USD (limits.monthly_max_usd). Example: 30. | |
| CAPPED_VIDEO_CONFIRM_FALLBACK | No | Behavior when the client does not support confirmation: allow or deny (limits.confirm_fallback). Example: allow. | |
| CAPPED_VIDEO_MAX_DURATION_SEC | No | Maximum allowed duration in seconds (limits.max_duration_sec). Example: 10. | |
| CAPPED_VIDEO_MAX_PENDING_JOBS | No | Maximum number of pending jobs (limits.max_pending_jobs). Example: 3. | |
| CAPPED_VIDEO_CONFIRM_ABOVE_USD | No | Threshold in USD above which the server asks the user to confirm before generation; 0 disables (limits.confirm_above_usd). Example: 0.5. | |
| CAPPED_VIDEO_DEFAULT_RESOLUTION | No | Default resolution (defaults.resolution). Example: 480p. | |
| CAPPED_VIDEO_DEFAULT_ASPECT_RATIO | No | Default aspect ratio (defaults.aspect_ratio). Example: 9:16. | |
| CAPPED_VIDEO_DEFAULT_DURATION_SEC | No | Default duration in seconds (defaults.duration_sec). Example: 5. | |
| CAPPED_VIDEO_DUPLICATE_WINDOW_MINUTES | No | Time window in minutes for treating identical requests as duplicates; 0 disables (limits.duplicate_window_minutes). Example: 10. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
영상 생성 서버입니다. generate_video 는 과금되므로 사용자가 요청할 때만 부르세요. 생성 후에는 get_video_status 로 완료를 확인합니다. 완료된 영상은 서버가 출력 폴더에 자동 저장하고, get_video_status 가 파일 경로를 알려 줍니다. 결과 수거는 이 서버(세션)가 켜져 있는 동안에만 일어납니다. 생성 중에는 세션을 닫지 않는 것이 좋습니다. 오류 메시지가 "다시 보내지 마세요"라고 하면 같은 요청을 반복하지 마세요 (이중 과금 위험). 모델·가격은 list_models, 남은 예산은 get_usage 로 확인합니다. 어떤 모델이 얼마인지, 예산 안에서 가장 싼 모델이 무엇인지는 estimate_video (무료) 로 먼저 봅니다. 완성된 영상은 preview_video (무료) 로 프레임 이미지를 받아 결과가 요청과 맞는지 눈으로 확인합니다.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_videoA | 영상 생성 작업을 만든다. 과금된다. 사용자가 영상 생성을 요청했을 때만 부른다. |
| get_video_statusA | 작업 상태를 확인한다. 과금되지 않는다. |
| download_videoA | 내려받지 못한(lost) 작업의 다운로드를 다시 시도하거나, 완료된 파일 경로를 돌려준다. 과금되지 않는다. 보통은 서버가 자동으로 내려받으므로 부를 필요가 없다. URL 이나 경로는 받지 않는다. |
| get_usageA | 오늘·이번 달 생성 횟수와 예상 비용, 상한, 진행 중인 작업 수를 돌려준다. |
| preview_videoA | 완성된 영상의 프레임 여러 장을 한 이미지로 붙여 돌려준다. 과금되지 않는다. |
| estimate_videoA | 과금 없이 비용을 견적한다. 조건(길이·해상도·화면 비율)에 맞는 모델을 싼 순서로, 남은 예산과 함께 돌려준다. |
| list_modelsA | 사용할 수 있는 모델, 해상도별 초당 가격(USD), 길이 범위, 기본값을 돌려준다. |
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 7 tools
Each tool targets a distinct lifecycle stage: pricing (estimate_video/list_models), creation (generate_video), polling (get_video_status), recovery (download_video), inspection (preview_video), and budget (get_usage). The descriptions explicitly state when NOT to call a tool (download_video: 'usually unnecessary'; generate_video: only when user requests creation), which removes the main overlap risk. The paid-vs-free distinction is stated on every tool.
All names follow a consistent snake_case verb_noun pattern: generate_video, estimate_video, preview_video, download_video, list_models, get_usage, get_video_status. The only minor variation is the three-part get_video_status, which still fits the scheme.
Seven tools map cleanly onto one domain (generate, check, fetch, preview, price, list, budget) with no filler. Each tool earns its place, and none could be merged without losing a distinct paid/free or blocking/non-blocking behavior.
The generation lifecycle is well covered: model discovery, cost estimation, creation, polling, recovery download, preview, and budget tracking. Missing operations are cancel/abort for an in-flight paid job and a list of past jobs; today an agent must retain job_ids itself, though this is a workable gap.