hashgraph-online 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 |
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. fromvidseeds_transcribe_audioor 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. AcceptsprojectId(loads transcript/meaning) or directtranscript. 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, 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.
Source: hashgraph-online/awesome-codex-plugins → plugins/CarrotGamesStudios/vidseeds-mcp/skills/vidseeds-projects/SKILL.md