From vidseeds
Use before expensive VidSeeds MCP workflows — seeds, daily MCP call quotas, async jobId polling, when to call vidseeds_get_seed_balance, and avoiding retry loops on MCP_QUOTA_EXCEEDED or insufficient seeds.
How this skill is triggered — by the user, by Claude, or both
Slash command
/vidseeds:vidseeds-efficiencyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Read this before multi-step or charge-bearing workflows.
Read this before multi-step or charge-bearing workflows.
New to this server, or unsure which tool does the job? Call vidseeds_guide — it returns the capability map, the recommended tool chain for a stated goal, and what VidSeeds does not do. It is free and quota-exempt, so it never costs seeds or a call-bucket token. The server's initialize instructions and the vidseeds://guide resource carry the same orientation; workflow prompts (e.g. optimize-youtube-video, make-thumbnail) hand you the ready-made tool chain. Reach for these before concluding a capability is missing. Parameter-level field docs are intentionally omitted from tools/list JSON schemas to save context — use vidseeds_guide (with a goal) or read vidseeds://guide when you need argument semantics beyond types/enums.
tools/list description; when it is not there, call vidseeds_guide with the tool name for the confirmed cost. Confirm with the user before charge-bearing calls. (2026-06: use fields: ["description","tags"] on regenerate for light/correct-price partials; thumbnail edits cost more than generation when using input reference image.)| Plan | Refill / day | Bucket cap |
|---|---|---|
| Sprout | 1,000 | 2,000 |
| Growth | 3,000 | 6,000 |
| Harvest | 8,000 | 16,000 |
| Agency | 20,000 | 40,000 |
| Trial | 1,000 | 1,000 |
Free and quota-exempt: vidseeds_get_seed_balance, vidseeds_get_seed_balance_and_subscription, vidseeds_guide.
vidseeds_get_seed_balance — seeds, remaining included MCP calls, overage rate (free).vidseeds_guide when the description omits it).Many writes return immediately with jobId (and often pollTool or a named poll tool in the response):
jobId and expectedCostSeeds if present.completed or failed.failed, surface the error once; do not retry in a tight loop.Examples:
| Start | Poll |
|---|---|
vidseeds_generate_thumbnail | vidseeds_get_thumbnail_job |
vidseeds_regenerate_project_metadata_async | vidseeds_get_regenerate_project_metadata_job |
vidseeds_create_project_metadata_async | vidseeds_get_create_project_metadata_job |
vidseeds_optimize_marketing_metadata_async | vidseeds_get_optimize_marketing_metadata_job |
Thumbnail generation is typically 70–100s. Project metadata regeneration can be 60–130s — prefer async variants for production.
| Code / message | Action |
|---|---|
AUTH_REQUIRED / 401 | PAT missing — see vidseeds-setup |
SUBSCRIPTION_REQUIRED / 402 | Trial ended — user must subscribe |
MCP_QUOTA_EXCEEDED | Stop retrying; show top-up link from error; wait for bucket refill or add seeds |
| Insufficient seeds | vidseeds_get_seed_balance; user tops up at https://vidseeds.ai/seeds |
vidseeds_get_project_snapshot when you need project + platform rows in one call instead of many get_project loops.vidseeds_list_platform_connections before per-id fetches unless you already have connectionId.vidseeds_get_bulk_video_metadata when comparing many videos.requestId / idempotency keys on retries the tool docs allow — avoids double billing.tools/list is enoughtools/list descriptions are compressed (first sentence + safety signals: seed cost, destructive warnings, async polling); parameter shapes and full argument semantics live in vidseeds_guide / vidseeds://guide. Skills teach composition; do not duplicate the full catalog here.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub carrotgamesstudios/vidseeds-mcp --plugin vidseeds