hashgraph-online/awesome-codex-plugins / plugins/CarrotGamesStudios/vidseeds-mcp/skills/vidseeds-efficiency
vidseeds-efficiency
UnverifiedUse 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.
VidSeeds MCP efficiency
Read this before multi-step or charge-bearing workflows.
Orient first (free)
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.
Two cost layers
- Per-tool seeds - Some tools spend seeds (thumbnails, intelligence, translation, etc.). Read-only tools are free. Charge-bearing tools state their seed cost in the first sentence of their compressed
tools/listdescription; when it is not there, callvidseeds_guidewith the tool name for the confirmed cost. Confirm with the user before charge-bearing calls. (2026-06: usefields: ["description","tags"]on regenerate for light/correct-price partials; thumbnail edits cost more than generation when using input reference image.) - Daily MCP call quota - Almost every tool call counts toward a plan bucket (continuous refill, not midnight reset). When the bucket is empty, each extra call costs 1 seed on top of any per-tool cost.
| 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.
Before expensive work
vidseeds_get_seed_balance- seeds, remaining included MCP calls, overage rate (free).- Tell the user expected per-tool seed cost (from the tool's compressed description, or
vidseeds_guidewhen the description omits it). - Prefer async + poll for long jobs instead of hammering sync tools that may time out at the edge.
Promo campaign note: vidseeds_generate_promo_campaign_pack is seed-charged on successful AI generation; conversion to drafts with vidseeds_create_social_posts_from_campaign_pack is not the billable AI step.
Async job pattern
Many writes return immediately with jobId (and often pollTool or a named poll tool in the response):
- Call the async or generate tool → capture
jobIdandexpectedCostSeedsif present. - Poll the indicated tool every ~3s until
completedorfailed. - On
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.
Errors - do not spin
| 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 |
Minimize round-trips
- Use
vidseeds_get_project_snapshotwhen you need project + platform rows in one call instead of manyget_projectloops. - For connections,
vidseeds_list_platform_connectionsbefore per-id fetches unless you already haveconnectionId. - Batch discovery:
vidseeds_get_bulk_video_metadatawhen comparing many videos. - Reuse the same
requestId/ idempotency keys on retries the tool docs allow - avoids double billing.
When tools/list is enough
tools/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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |