Projects (MCP)
A project is the workspace for one video across YouTube, TikTok, Instagram, Facebook, LinkedIn, and X.
Discover projects
vidseeds_list_projects— browse with limits/filters per tool schema.vidseeds_get_project— single project record.vidseeds_get_project_snapshot— project + platform config in one call (prefer over many gets).
Create from YouTube
vidseeds_create_project_from_youtubewith the YouTube video id/URL (see tool inputs).- If metadata generation is async, poll
vidseeds_get_create_project_metadata_jobuntilcompleted. - Confirm with
vidseeds_get_project_snapshot.
Regenerate platform metadata
Re-runs optimized titles/descriptions/tags per platform from the stored transcript.
| Mode | Tool | Notes |
|---|---|---|
| Fast / small | vidseeds_regenerate_project_metadata |
Can exceed ~100s edge timeout on large projects |
| Production | vidseeds_regenerate_project_metadata_async |
Returns jobId immediately |
| Poll | vidseeds_get_regenerate_project_metadata_job |
Same result shape as sync when done |
Voice: If the user has multiple YouTube channels, pass channelId (UC…). With one connection, omit for auto-resolve. voiceBlendRatio optional (tool default documented in tools/list).
Reuse the same requestId on transport retries to avoid double seed charges when the tool allows it.
Optimize metadata without a full project (standalone)
vidseeds_optimize_marketing_metadata/vidseeds_optimize_marketing_metadata_async— needs transcript (e.g. fromvidseeds_transcribe_audioor YouTube transcript tools).- Poll:
vidseeds_get_optimize_marketing_metadata_job.
Translate project metadata
vidseeds_translate_project_metadata— localization across supported languages (no voice dubbing on VidSeeds.ai).
Thumbnail on project
- Generate per
vidseeds-thumbnails, thenvidseeds_apply_thumbnail_to_project.
Per-platform publish config
vidseeds_update_project_platform_config— enable platform, title/description/tags, schedule, connection, thumbnail URL override.
Publish
After config is ready, use vidseeds-publishing (vidseeds_preflight_publish → vidseeds_confirm_publish / vidseeds_publish_project).
History
vidseeds_list_optimization_history,vidseeds_get_optimization_history_item,vidseeds_reoptimize_history_item— past runs and re-run from history.