git:20260527.80a7c74 to git:20260615.9a28338

1 added, 1 removed. Audit A to A.

---

name: vidseeds-publishing

description: Use for VidSeeds MCP publishing — platform connections, OAuth connect URLs, activate YouTube channel, update connection settings, preflight/confirm/cancel publish, publish status, direct YouTube upload, and updating live YouTube metadata.

---

# Publishing & connections (MCP)

## Connect platforms

1. `vidseeds_list_platform_connections` — see what is connected (no OAuth secrets returned).

2. `vidseeds_get_platform_connect_url` — OAuth URL for a platform the user must open in a browser.

3. After OAuth completes, list again to get `connectionId`.

**YouTube channel selection (multi-channel accounts):**

- `vidseeds_set_active_youtube_channel` — which channel is active for uploads/metadata.

**Settings:**

- - `vidseeds_update_connection_settings` — per-connection options (e.g. content language, description footer).

+ - `vidseeds_update_connection_settings` — per-connection options (e.g. content language, description footer, and per-asset generation guidelines for titles/descriptions/tags/thumbnails). Read current values via `vidseeds_get_platform_connection`. Guidelines are sent to the model on every generation by default; generation tools accept `applyGuidelines: false` to ignore them for one call.

- `vidseeds_disconnect_platform_connection` — remove a connection.

## Publish a project

Typical sequence:

1. `vidseeds_get_project_snapshot` — verify per-platform config (`vidseeds_update_project_platform_config` if needed).

2. `vidseeds_preflight_publish` — compatibility checks before spend.

3. `vidseeds_confirm_publish` or `vidseeds_publish_project` — start publish (see tool descriptions for `now` vs `scheduled`).

4. `vidseeds_get_publish_status` — poll until platforms complete or fail.

5. On failure: `vidseeds_retry_publish_target`; to abort schedule: `vidseeds_cancel_or_unschedule_publish`.

## Direct YouTube upload (bypassing manual Studio upload)

For large files the user uploads from their machine through VidSeeds:

1. `vidseeds_prepare_youtube_upload` — session/upload instructions.

2. User/agent completes bytes per returned guidance.

3. `vidseeds_complete_youtube_upload` — finalize.

Pair with project metadata from `vidseeds-projects`.

## Update live YouTube video metadata

- `vidseeds_update_youtube_metadata` — patch title/description/tags on an existing video (connected channel).

## Thumbnail on YouTube

- `vidseeds_publish_thumbnail_to_youtube` — set thumbnail on a published video (see `vidseeds-thumbnails`).

## Channel description

- `vidseeds_publish_channel_description` — update channel-level description when supported.

## History republish

- `vidseeds_republish_history_item` — re-send from optimization history (check tool inputs).

## Before publishing

- Confirm seeds and quota: `vidseeds-efficiency` (`vidseeds_get_seed_balance`).

- Ensure the right `connectionId` is set on each enabled platform in project config.