Server definition
- Hash
- sha256:b7c92da53e2a52912d40b40e922dfdf8f1ae5183f57cb0344d022971acacfdf2
- What it is
- What a remote MCP server returned when asked what it offers: 19 tools
The blob, as servednamed by its sha256
{
"instructions": "Create and run 24/7 linear TV channels. Typical flow: get_account_status to learn the tier and quota, create_channel, import_video_from_url for each video (setting its weight as you go), poll get_transcode_status until meetsLaunchRequirements is true, then get_channel until scheduleStatus is 'active' and report {handle}.my-tv-channel.com to the owner. A channel needs 4+ ready videos and 15+ minutes before it can go live. If you change weights on an already-live channel, call regenerate_schedule or the change will not air.",
"tools": [
{
"description": "Take a channel off the air and out of every listing. This ARCHIVES rather than destroys: the handle stays reserved and assets and schedule history are retained, so it can be restored. Refuses with 409 while transcodes are still running. Idempotent. This is the reversible way to take a channel down; delete_asset removes individual videos instead.",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
}
},
"required": [
"channel_id"
],
"type": "object"
},
"name": "archive_channel",
"outputSchema": null
},
{
"description": "Check whether a channel handle is free before trying to create it. The handle becomes the subdomain: {handle}.my-tv-channel.com. 3-63 chars, lowercase a-z, 0-9 and hyphens.",
"inputSchema": {
"properties": {
"handle": {
"description": "Desired handle, e.g. \"retro-arcade\"",
"type": "string"
}
},
"required": [
"handle"
],
"type": "object"
},
"name": "check_handle_available",
"outputSchema": null
},
{
"description": "Create a 24/7 linear TV channel. It will NOT be live yet — a channel goes live automatically once it has at least 4 ready assets AND at least 15 minutes of total content. is_public lists it in Discover and is available on every subscription tier, including Starter.",
"inputSchema": {
"properties": {
"category": {
"type": "string"
},
"channel_type": {
"description": "Use \"thematic\" unless the channel is tied to a place",
"enum": [
"thematic",
"location"
],
"type": "string"
},
"description": {
"type": "string"
},
"handle": {
"description": "3-63 chars, lowercase a-z 0-9 and hyphens. Becomes {handle}.my-tv-channel.com",
"type": "string"
},
"is_public": {
"description": "List in Discover. Available on all tiers.",
"type": "boolean"
},
"location": {
"description": "Required only when channel_type is \"location\"",
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"name": {
"type": "string"
},
"radius_km": {
"type": "number"
}
},
"type": "object"
},
"name": {
"description": "Display name",
"type": "string"
},
"orientation": {
"description": "vertical = 9:16",
"enum": [
"horizontal",
"vertical"
],
"type": "string"
},
"primary_language": {
"description": "ISO 639-1, e.g. \"en\", \"fr\"",
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"handle",
"name",
"channel_type"
],
"type": "object"
},
"name": "create_channel",
"outputSchema": null
},
{
"description": "Remove a video from a channel. Soft delete — it stops being scheduled immediately and the schedule regenerates automatically. Idempotent. The asset is retained and stops being scheduled; it is not erased. Affects one video — archive_channel takes a whole channel off the air.",
"inputSchema": {
"properties": {
"asset_id": {
"type": "integer"
}
},
"required": [
"asset_id"
],
"type": "object"
},
"name": "delete_asset",
"outputSchema": null
},
{
"description": "Start here. Returns who the account is, its subscription tier and limits, how much weekly upload/stream quota is used and remaining, and every channel the owner has with its ready-asset count and what it still needs to go live (launchGaps). Call this before creating anything so you know the real limits for THIS account rather than assuming.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_account_status",
"outputSchema": null
},
{
"description": "Get one channel by id. Includes scheduleStatus (inactive | pending | active | error) — poll this to confirm a channel has gone live — plus watchUrl, launchedAt and isArchived.",
"inputSchema": {
"properties": {
"channel_id": {
"description": "Channel id",
"type": "integer"
}
},
"required": [
"channel_id"
],
"type": "object"
},
"name": "get_channel",
"outputSchema": null
},
{
"description": "Read the channel's EPG — what is playing and what is coming up. Note this one returns a plain array of entries (unlike other tools, which return an object).",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
}
},
"required": [
"channel_id"
],
"type": "object"
},
"name": "get_schedule",
"outputSchema": null
},
{
"description": "Read the channel's declarative schedule rules (fixed time slots and dayparts), plus its scheduling mode and timezone.",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
}
},
"required": [
"channel_id"
],
"type": "object"
},
"name": "get_schedule_rules",
"outputSchema": null
},
{
"description": "Poll transcode progress. Give either channel_id (all its videos) or asset_id (one). Each asset reports uploadStatus (downloading -> pending -> transcoding -> ready) and the summary tells you when meetsLaunchRequirements becomes true: 4+ ready assets AND 900+ seconds. Poll every 30-60s; transcoding takes roughly real-time/4.",
"inputSchema": {
"properties": {
"asset_id": {
"type": "integer"
},
"channel_id": {
"type": "integer"
}
},
"required": [],
"type": "object"
},
"name": "get_transcode_status",
"outputSchema": null
},
{
"description": "Add a video to a channel from a direct media URL. THIS IS THE MAIN WAY TO ADD CONTENT over MCP — you cannot upload local file bytes through this interface, so if the owner has local files, ask them to host them somewhere reachable or upload via the app. The URL must be a direct, public, unauthenticated link to mp4/mov/m4v/mpeg/mpg/avi, or a FINITE .m3u8 (VOD, not a live stream) — not a web page, not behind a login, not a YouTube/Vimeo watch page. The server downloads it. Returns immediately; the asset then goes downloading -> pending -> transcoding -> ready. Duration counts against the weekly upload quota. Re-submitting the same URL to the same channel returns the original asset instead of importing twice.",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
},
"url": {
"description": "Direct, public media URL",
"type": "string"
},
"weight": {
"description": "How often it plays, 0-10 (default 5). Set it here rather than after — see set_asset_weight.",
"maximum": 10,
"minimum": 0,
"type": "integer"
}
},
"required": [
"channel_id",
"url"
],
"type": "object"
},
"name": "import_video_from_url",
"outputSchema": null
},
{
"description": "Import a YouTube video that the OWNER UPLOADED THEMSELVES. This will not work for anyone else's video, by design — a channel built from other people's videos is a copyright problem for the owner.\n\nOwnership is proved by a tag only the uploader can add:\n 1. The owner's tag looks like 'MyTVChannelApp#<device-id>'. When the import fails for a missing tag, the 403 error message contains that account's exact tag string.\n 2. They paste that exact string into the video's description or tags on YouTube.\n 3. Retry the import.\n\nYou cannot do step 2 for them and you cannot bypass it. Public finished videos only: no live streams, no private or age-restricted videos, no playlists or channel URLs. Capped at 10 per day. Counts against the same weekly upload quota as everything else.",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Overrides the YouTube title",
"type": "string"
},
"url": {
"description": "A single-video YouTube URL (watch, shorts or youtu.be)",
"type": "string"
},
"weight": {
"maximum": 10,
"minimum": 0,
"type": "integer"
}
},
"required": [
"channel_id",
"url"
],
"type": "object"
},
"name": "import_youtube_video",
"outputSchema": null
},
{
"description": "List the videos on a channel.",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
}
},
"required": [
"channel_id"
],
"type": "object"
},
"name": "list_assets",
"outputSchema": null
},
{
"description": "List the channels owned by this account.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "list_channels",
"outputSchema": null
},
{
"description": "Rebuild the channel's schedule now using the current weights. Call this after changing weights on a channel that is ALREADY live, otherwise the change will not air until the hourly cron. Throttled to one call per channel per 5 minutes; exceeding that returns 429 with a Retry-After header giving the seconds remaining. Requires the channel to meet launch requirements.",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
}
},
"required": [
"channel_id"
],
"type": "object"
},
"name": "regenerate_schedule",
"outputSchema": null
},
{
"description": "Re-queue a video whose transcode failed. Only works on assets in a failed state.",
"inputSchema": {
"properties": {
"asset_id": {
"type": "integer"
}
},
"required": [
"asset_id"
],
"type": "object"
},
"name": "retry_transcode",
"outputSchema": null
},
{
"description": "Change how often a video plays (weight 0-10, default 5; 0 removes it from rotation entirely), and optionally its title or tags. IMPORTANT ORDERING: weights only affect what actually airs when the schedule is (re)generated. A channel builds its schedule the instant it crosses the launch threshold, so weights set AFTER that are stored but do not air. Either set the weight when you import each video, or call regenerate_schedule afterwards. Weights are relative: identical weights across every video produce a uniform rotation, and the spread between them is what shapes airtime.",
"inputSchema": {
"properties": {
"asset_id": {
"type": "integer"
},
"tags": {
"description": "Tag videos seqXX01, seqXX02 … (XX = any two letters) to force them to play in order as a mini-series.",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
},
"weight": {
"maximum": 10,
"minimum": 0,
"type": "integer"
}
},
"required": [
"asset_id"
],
"type": "object"
},
"name": "set_asset_weight",
"outputSchema": null
},
{
"description": "Give the channel a durable schedule: fixed slots (\"news at 18:00\") and dayparts (\"no kids content after 22:00\"). The scheduler re-honours these on EVERY rebuild, so you set them once instead of babysitting the grid. **Pro tier or higher.**\n\nThis REPLACES the entire ruleset — send every rule you want, not just new ones. Sending an empty array removes all rules and returns the channel to plain weighted-random. Validate first with validate_schedule_rules.\n\nRule shapes:\n time_slot {rule_type:'time_slot', start_time:'18:00', end_time?:'21:00',\n days_mask:127, selector_type:'asset'|'tag'|'playlist',\n selector_value:<id|tag|[ids]>, priority?:0}\n daypart_weight {rule_type:'daypart_weight', start_time:'22:00', end_time:'06:00',\n days_mask:127, selector_type:'asset'|'tag', selector_value:...,\n weight_multiplier:0-10}\n\ndays_mask is a bitmask: bit0=Mon … bit6=Sun. 127=daily, 31=Mon-Fri, 96=weekend.\nend_time on a time_slot makes it a BLOCK that keeps drawing from the selector until that time — that is how you get 'cartoons 06:00-09:00' rather than one cartoon.\nselector_type 'playlist' with an array of asset ids plays them IN ORDER.\nweight_multiplier 0 removes matching assets from that window entirely.\n\nSet `timezone` (IANA) or the times mean UTC, which is almost never what the owner meant. Slots start ON-OR-AFTER their time: the programme running into a slot is never cut short, so an 18:00 slot may begin at 18:02. That is intended.",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
},
"rules": {
"description": "The COMPLETE ruleset. Empty array clears all rules.",
"items": {
"properties": {
"days_mask": {
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"end_time": {
"description": "Required for daypart_weight; on a time_slot makes it a block",
"type": "string"
},
"priority": {
"description": "Higher wins when slots overlap",
"type": "integer"
},
"rule_type": {
"enum": [
"time_slot",
"daypart_weight"
],
"type": "string"
},
"selector_type": {
"enum": [
"asset",
"tag",
"playlist"
],
"type": "string"
},
"selector_value": {
"description": "Asset id, tag name, or array of asset ids"
},
"start_time": {
"description": "HH:MM or HH:MM:SS, wall clock in the channel timezone",
"type": "string"
},
"weight_multiplier": {
"maximum": 10,
"minimum": 0,
"type": "number"
}
},
"required": [
"rule_type",
"start_time",
"selector_type",
"selector_value"
],
"type": "object"
},
"type": "array"
},
"timezone": {
"description": "IANA name, e.g. \"Europe/Paris\". Strongly recommended.",
"type": "string"
}
},
"required": [
"channel_id",
"rules"
],
"type": "object"
},
"name": "set_schedule_rules",
"outputSchema": null
},
{
"description": "Update an existing channel: name, description, visibility, category, language, age rating, or the community chat link. Only send the fields you are changing.",
"inputSchema": {
"properties": {
"age_classification": {
"enum": [
"4+",
"9+",
"13+",
"16+",
"18+"
],
"type": "string"
},
"allow_offline_download": {
"type": "boolean"
},
"category": {
"type": "string"
},
"channel_id": {
"type": "integer"
},
"chat_channel_id": {
"description": "Discord channel id within that server",
"type": "string"
},
"chat_platform": {
"description": "Community chat platform shown as an overlay on the player. Discord is the fully supported one; the others are accepted but only Discord has a working embed today.",
"enum": [
"discord",
"guilded",
"matrix",
"revolt",
"kick",
"restream"
],
"type": "string"
},
"chat_server_id": {
"description": "Discord server (guild) id — the owner must supply this; you cannot discover it",
"type": "string"
},
"description": {
"type": "string"
},
"is_public": {
"description": "List in Discover. Allowed on every tier.",
"type": "boolean"
},
"keywords": {
"description": "Multilingual search keywords",
"type": "string"
},
"name": {
"type": "string"
},
"primary_language": {
"description": "ISO 639-1, e.g. \"en\"",
"type": "string"
},
"show_schedule": {
"type": "boolean"
}
},
"required": [
"channel_id"
],
"type": "object"
},
"name": "update_channel",
"outputSchema": null
},
{
"description": "DRY-RUN a ruleset. Saves nothing. Returns {valid, errors, warnings, preview} where preview is a simulated 24h grid of what would actually air. Intended as the dry run for set_schedule_rules: rules are wall-clock, slots start on-or-after their time, and dayparts reweight the random fill, so the airing result is hard to predict from the rules alone. Unlike set_schedule_rules this is not tier-gated and works on any tier. Same payload as set_schedule_rules.",
"inputSchema": {
"properties": {
"channel_id": {
"type": "integer"
},
"hours": {
"description": "How many hours to simulate (default 24, max 168)",
"type": "integer"
},
"rules": {
"description": "Same shape as set_schedule_rules",
"items": {
"type": "object"
},
"type": "array"
},
"timezone": {
"description": "IANA name, e.g. \"Europe/Paris\"",
"type": "string"
}
},
"required": [
"channel_id",
"rules"
],
"type": "object"
},
"name": "validate_schedule_rules",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:b7c92da53e2a52912d40b40e922dfdf8f1ae5183f57cb0344d022971acacfdf2 | sha256sum