MCP: expand tools for creative scheduling #17

New Issue

GKaszewski · 2026-07-12T05:50:22Z

GKaszewski commented

2026-07-12 05:50:22 +00:00

Parent

What to build

Expand the MCP crate's tool set so an AI agent can act as a creative programming director — not just CRUD, but library analysis, schedule design, and EPG review.

New tools to add:

browse_library — search/filter the library with rich parameters (genre, decade, series, content type, role, duration range). Returns summaries, not raw item lists.
library_stats — aggregate stats: total items, items by genre, items by content type, items by role (Program vs Interstitial), series with episode counts, recently synced items.
analyze_schedule — given a channel, report what's been airing: most-played items, genre distribution, rotation coverage, upcoming gaps.
suggest_schedule — given constraints (genre, time block, target audience), suggest a ScheduleConfig using the library's content. The agent provides creative direction, the tool returns a concrete config.
preview_schedule — dry-run schedule generation: given a ScheduleConfig, generate a preview (next 24h of slots) without persisting.
set_interstitial_rule — configure interstitials on a ProgrammingBlock
set_mid_roll_rule — configure mid-roll breaks on a ProgrammingBlock
set_gap_filler — configure gap filler on a Channel

Acceptance criteria

browse_library tool returns filtered library results via MCP
library_stats tool returns aggregate statistics
analyze_schedule tool returns schedule analysis for a channel
preview_schedule tool generates a non-persisted preview
set_interstitial_rule / set_mid_roll_rule / set_gap_filler tools work
All new tools use application use cases or domain ports (not raw SQL)
An agent can use these tools to design a thematic channel from scratch

Blocked by

#3 (FillStrategy wiring — new strategies must work for creative scheduling)
#4 (Interstitial insertion — interstitial tools need the engine to support them)

## Parent #2 ## What to build Expand the MCP crate's tool set so an AI agent can act as a creative programming director — not just CRUD, but library analysis, schedule design, and EPG review. New tools to add: - **browse_library** — search/filter the library with rich parameters (genre, decade, series, content type, role, duration range). Returns summaries, not raw item lists. - **library_stats** — aggregate stats: total items, items by genre, items by content type, items by role (Program vs Interstitial), series with episode counts, recently synced items. - **analyze_schedule** — given a channel, report what's been airing: most-played items, genre distribution, rotation coverage, upcoming gaps. - **suggest_schedule** — given constraints (genre, time block, target audience), suggest a ScheduleConfig using the library's content. The agent provides creative direction, the tool returns a concrete config. - **preview_schedule** — dry-run schedule generation: given a ScheduleConfig, generate a preview (next 24h of slots) without persisting. - **set_interstitial_rule** — configure interstitials on a ProgrammingBlock - **set_mid_roll_rule** — configure mid-roll breaks on a ProgrammingBlock - **set_gap_filler** — configure gap filler on a Channel ## Acceptance criteria - [ ] browse_library tool returns filtered library results via MCP - [ ] library_stats tool returns aggregate statistics - [ ] analyze_schedule tool returns schedule analysis for a channel - [ ] preview_schedule tool generates a non-persisted preview - [ ] set_interstitial_rule / set_mid_roll_rule / set_gap_filler tools work - [ ] All new tools use application use cases or domain ports (not raw SQL) - [ ] An agent can use these tools to design a thematic channel from scratch ## Blocked by - #3 (FillStrategy wiring — new strategies must work for creative scheduling) - #4 (Interstitial insertion — interstitial tools need the engine to support them)

GKaszewski added the ready-for-agent label 2026-07-12 05:50:22 +00:00

GKaszewski referenced this issue from a commit

2026-07-12 13:13:34 +00:00

expand MCP tools: browse_library, stats, analyze, preview, suggest, config tools (#17)

GKaszewski closed this issue

2026-07-12 13:13:48 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GKaszewski/k-tv#17