# PBS Media Manager

Source: https://pilot.braike.com/en/docs/regies/pbs-media-manager

The 12 read-only tools Pilot MCP serves for PBS Media Manager, taken from the server.

Pilot MCP serves **12 tools** for PBS Media Manager, all read-only, on every plan. Their names start with `pbs_media_manager_`. The connector has no tool that writes.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 12 |

## Other tools [#autres]

### `pbs_media_manager_get_asset` [#pbs_media_manager_get_asset]

**PBS Media Manager: Get Asset** · read-only · idempotent

A PBS Media Manager asset by its id or slug: video files, captions and images, and availability windows by audience (start and end dates). Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `asset` | `string` | yes | The id (PBS Content ID) or the slug of the asset. |

### `pbs_media_manager_get_changelog` [#pbs_media_manager_get_changelog]

**PBS Media Manager: Get Changelog** · read-only · idempotent

The PBS Media Manager changelog for the last 30 days: creations, updates and deletions of assets, shows, franchises, seasons, episodes, specials, collections and stations, with the date (UTC) and the changed fields. Filters by type, action, resource and date. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `since` | `string` | no | Activity from this instant on, within the last 30 days (UTC). |
| `type` | `string[]` | no | Values: `"asset"`, `"show"`, `"franchise"`, `"special"`, `"episode"`, `"season"`, `"collection"`, `"station"`. |
| `action` | `string[]` | no | Values: `"create"`, `"update"`, `"delete"`. |
| `id` | `string[]` | no | Keep only these resources (PBS Content ID). |
| `with_assets` | `boolean` | no | With show \`id\` values: adds the activity of all their assets. |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
| `page` | `integer` | no | Starting page, to read the rest of a truncated list. |

### `pbs_media_manager_get_show` [#pbs_media_manager_get_show]

**PBS Media Manager: Get Show** · read-only · idempotent

A PBS Media Manager show by its id or slug, with its ten latest clips and previews, its seasons and its recent specials. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `show` | `string` | yes | The id (PBS Content ID) or the slug of the show. |

### `pbs_media_manager_list_assets` [#pbs_media_manager_list_assets]

**PBS Media Manager: List Assets** · read-only · idempotent

The PBS Media Manager assets (full-length videos, clips, previews, with captions and images): id, title, type (full\_length, clip, preview), duration, dates, availability by audience (public, all\_members, station\_members), platforms and countries. Filters by show, availability, platform, country, parent type. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `show_id` | `string` | no | Keep only the assets of this show (id). |
| `available` | `string` | no | Keep only the assets available to this audience. Values: `"public"`, `"all_members"`, `"station_members"`. |
| `platform_slug` | `string` | no | Platform (e.g. bento, partnerplayer); required if the assets are not on every platform. |
| `country` | `string` | no | Country (two-letter uppercase code, e.g. US). |
| `parent_type` | `string` | no | Type of the direct parent of the assets. Values: `"episode"`, `"special"`, `"show"`, `"season"`, `"franchise"`. |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
| `page` | `integer` | no | Starting page, to read the rest of a truncated list. |

### `pbs_media_manager_list_collections` [#pbs_media_manager_list_collections]

**PBS Media Manager: List Collections** · read-only · idempotent

The collections of a PBS Media Manager show (a selection of episodes and specials): id, title, slug. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `show_id` | `string` | yes | The id (PBS Content ID) or the slug of the show. |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
| `page` | `integer` | no | Starting page, to read the rest of a truncated list. |

### `pbs_media_manager_list_episodes` [#pbs_media_manager_list_episodes]

**PBS Media Manager: List Episodes** · read-only · idempotent

The episodes of a PBS Media Manager season: id, title, number, descriptions, premiere and encore dates (encored\_on). Filter by encore date. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `season_id` | `string` | yes | The id (PBS Content ID) or the slug of the season. |
| `encored_on_or_after` | `string` | no | Encored on or after this date (YYYY-MM-DD). |
| `encored_on_or_before` | `any` | no | Encored on or before this date (YYYY-MM-DD). |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
| `page` | `integer` | no | Starting page, to read the rest of a truncated list. |

### `pbs_media_manager_list_franchises` [#pbs_media_manager_list_franchises]

**PBS Media Manager: List Franchises** · read-only · idempotent

The PBS Media Manager franchises visible to the workspace key (a brand or grouping of series, with no episodes of its own): id, title, slug, descriptions. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `platform_slug` | `string` | no | Keep only the franchises available on this platform (e.g. partnerplayer, bento). |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
| `page` | `integer` | no | Starting page, to read the rest of a truncated list. |

### `pbs_media_manager_list_seasons` [#pbs_media_manager_list_seasons]

**PBS Media Manager: List Seasons** · read-only · idempotent

The seasons of a PBS Media Manager show: id, number (ordinal), title. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `show_id` | `string` | yes | The id (PBS Content ID) or the slug of the show. |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
| `page` | `integer` | no | Starting page, to read the rest of a truncated list. |

### `pbs_media_manager_list_shows` [#pbs_media_manager_list_shows]

**PBS Media Manager: List Shows** · read-only · idempotent

The PBS Media Manager shows: id, title, slug, descriptions, audiences, genre, platforms, number of episodes, last update. Filters by franchise and by genre. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `franchise_id` | `string` | no | Keep only the shows of this franchise (id). |
| `genre_slug` | `string` | no | Keep only this genre (slug, e.g. arts-and-music). |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
| `page` | `integer` | no | Starting page, to read the rest of a truncated list. |

### `pbs_media_manager_list_specials` [#pbs_media_manager_list_specials]

**PBS Media Manager: List Specials** · read-only · idempotent

The specials of a PBS Media Manager show (film, one-off event, outside any season): id, title, descriptions, dates. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `show_id` | `string` | yes | The id (PBS Content ID) or the slug of the show. |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
| `page` | `integer` | no | Starting page, to read the rest of a truncated list. |

### `pbs_media_manager_search_episodes` [#pbs_media_manager_search_episodes]

**PBS Media Manager: Search Episodes** · read-only · idempotent

Searches PBS Media Manager episodes by their title. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | `string` | yes |   |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |

### `pbs_media_manager_search_shows` [#pbs_media_manager_search_shows]

**PBS Media Manager: Search Shows** · read-only · idempotent

Searches PBS Media Manager shows by their title. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | `string` | yes | The title or part of the title. |
| `max_items` | `integer` | no | Number of items to return (50 by default, 200 at most). |
