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_youtube with the YouTube video id/URL (see tool inputs).- If metadata generation is async, poll
vidseeds_get_create_project_metadata_job until completed.
- 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 |
Pass focus: "titles" (with regenerate) to use the lightweight titles-only generator (still 1 seed, but far less AI work than full variants).
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.
Keep create, regenerate, and targeted field-refresh calls for the same video close together when possible. VidSeeds.ai reuses recent per-video analysis context for about an hour during a metadata workflow, so follow-up quality checks and regenerations are usually cheaper and faster when they stay in the same project flow.
Targeted / cheap regen (2026-06): Use fields: ["description", "tags"] (or include "title") on regenerate/optimize for light per-field generators (correct lower AI cost for the work, while the action still uses the reoptimize 1-seed price). For thumbnails or edits, use the dedicated thumbnail tools (pricing is per-image with model; edits that reference an input image cost more than pure generation).
Optimize metadata without a full project (standalone)
vidseeds_optimize_marketing_metadata / vidseeds_optimize_marketing_metadata_async - needs transcript (e.g. from vidseeds_transcribe_audio or YouTube transcript tools).- Poll:
vidseeds_get_optimize_marketing_metadata_job.
- Pass
focus: "titles" for title-only (light generator, 1 seed).
Suggest titles only (light 1-seed path for "new titles" requests)
vidseeds_suggest_titles - dedicated tool for title suggestions only. 1 seed. Accepts projectId (loads transcript/meaning) or direct transcript. Much lower AI cost than full optimize/regenerate. Use this (or regenerate+focus=titles) instead of create_new when user asks for title options. Idempotent with key.
Translate project metadata
vidseeds_translate_project_metadata - localization across supported languages (no voice dubbing on VidSeeds.ai).
Thumbnail on project
- Generate per
vidseeds-thumbnails, then vidseeds_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.