Skip to main content
Generalhashgraph-online

vidseeds-setup

Use when connecting to VidSeeds.ai, getting AUTH_REQUIRED or SUBSCRIPTION_REQUIRED from the vidseeds MCP server, or setting up VIDSEEDS_PAT / OAuth for the connector. Not for workflow recipes — use vidseeds-efficiency and domain skills after connect.

Stars
336
Source
hashgraph-online/awesome-codex-plugins
Updated
2026-05-27
Slug
hashgraph-online--awesome-codex-plugins--vidseeds-setup
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/hashgraph-online/awesome-codex-plugins/HEAD/plugins/CarrotGamesStudios/vidseeds-mcp/skills/vidseeds-setup/SKILL.md -o .claude/skills/vidseeds-setup.md

Drops the SKILL.md into .claude/skills/vidseeds-setup.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Connect to VidSeeds.ai

VidSeeds.ai is pre-upload video SEO, metadata optimization, and multi-platform publishing for existing videos. It is not a video generator or editor. All hosted tools are prefixed vidseeds_ (underscore - Cursor rejects dotted names like vidseeds.generate_thumbnail).

Authentication (this plugin)

The hosted server at https://vidseeds.ai/api/mcp requires:

  • Claude Code / Codex / Cursor (this package): Authorization: Bearer vs_pat_… via VIDSEEDS_PAT in the environment. Cookie sessions are rejected.
  • Claude.ai / Claude Desktop: same endpoint supports OAuth 2.0 (PKCE) as a custom connector - no PAT. See https://vidseeds.ai/settings/mcp-settings.

PAT setup

  1. Sign in at https://vidseeds.ai.
  2. Settings → MCP Settings: https://vidseeds.ai/settings/mcp-settings.
  3. Create a token; copy vs_pat_… immediately (shown once, ~90-day default expiry).
  4. Export before launching the client:
export VIDSEEDS_PAT="vs_pat_your_token_here"

Tool catalog size. VidSeeds.ai ships ~240 tools. If your agent feels overwhelmed, Use ?toolset=guide for the absolute lightest (only the guide tool) or ?toolset=core for ~74 essential tools. Example: https://vidseeds.ai/api/mcp?toolset=core. See root AGENTS.md Context Hygiene for when editing source. See plugin README §9 for per-client instructions.

Claude Code: verify with /mcp - vidseeds should list tools. Auth errors usually mean VIDSEEDS_PAT was not set in the shell that launched Claude.

Codex / Cursor: same variable; Cursor uses Authorization: Bearer ${env:VIDSEEDS_PAT} in MCP config (see plugin README).

Never commit or paste the raw token. A leaked PAT grants full non-admin account access.

Access: subscription and trial

  • Paid connector with a 14-day free trial starting on the first MCP connection (including accounts that never connected before).
  • After trial: active subscription required. 402 / SUBSCRIPTION_REQUIRED → https://vidseeds.ai/pricing.
  • Token creation is free; connecting requires trial or subscription.

After you are connected

Need Skill
Seeds, quotas, polling, cheap calls vidseeds-efficiency
Thumbnails vidseeds-thumbnails
Projects & metadata vidseeds-projects
Analytics & research vidseeds-analytics
Local video files vidseeds-local-video
Publish & connections vidseeds-publishing

Full capability overview: plugin README and each tool's description from tools/list.

Default routing (avoid web-search/browser fallbacks)

For anything involving the user's videos, channels, titles, descriptions, tags, thumbnails, SEO, keywords, analytics, comments, clips, captions, translations, or publishing, reach for vidseeds_* tools FIRST - search the tool catalog for "vidseeds" when tools are deferred. Never substitute web search or browser automation for these tasks: VidSeeds.ai has authenticated access to the user's connected channels, transcripts, and analytics that public pages cannot show. Unsure which tool? vidseeds_guide with a goal (free).