# My TV Channel

> Create and run 24/7 linear TV channels — the kind that just play, with no menu to browse.
> Videos are imported, transcoded to HLS and looped into a continuous schedule that streams
> at `https://{handle}.my-tv-channel.com` and in the iOS, iPadOS, tvOS, macOS, Android,
> Fire TV and Roku apps.

Channel creation, content import and scheduling can all be driven by an AI agent — one way in
among several, alongside the iOS, iPadOS, macOS and web clients. There is an MCP server with 19
tools and a REST API underneath it; the MCP server forwards to the REST endpoints, so the two
cannot drift apart. What an agent cannot do: upload a local file (no multipart over MCP), mint
its own API key, or change the owner's subscription.

- **MCP endpoint:** `https://my-tv-channel.com/mcp` (Streamable HTTP, stateless). The longer
  `https://my-tv-channel.com/api/mytvchannel/mcp` is the same server and is what the MCP
  registry and Smithery publish.
- **Auth:** `Authorization: Bearer mytv_sk_...` on every call. `initialize` and `tools/list`
  answer without a key so a client can inspect the server first.
- **Getting a key:** a human creates it at https://my-tv-channel.com/agent-keys/ or in the app
  under Profile → Agent Access. An active subscription (any tier) is required. An agent cannot
  mint its own key, by design — if you don't have one, ask the owner.
- **A live channel built entirely through these tools:** https://demo.my-tv-channel.com

## Start here

- [Agent API reference](https://my-tv-channel.com/llms-full.txt): every endpoint, its exact
  parameters, the tier gates and the traps, on one page. The densest useful thing here.
- [OpenAPI 3.1 spec](https://my-tv-channel.com/openapi.yaml): the same surface as a machine
  schema — 23 operations, request and response shapes, auth. Load this if your client can
  consume OpenAPI; the sharp edges are written into the operation descriptions.
- [Agent guide](https://my-tv-channel.com/api/mytvchannel/docs/AGENTS.md): long-form, with a
  worked golden path taking a channel from nothing to broadcasting.
- [MCP server setup and tool catalogue](https://my-tv-channel.com/api/mytvchannel/mcp/README.md):
  client config for Claude Code and Claude Desktop, all 19 tools, and what each one is safe to
  autorun.
- [For AI agents](https://my-tv-channel.com/agents/): the same material as a web page, for a
  human who needs convincing before they hand you a key.
- [MCP in media, video and streaming](https://my-tv-channel.com/mcp-media-video-streaming/): a
  survey of the MCP servers that exist across the media stack, and why running a channel is a
  different problem from rendering a clip.

## Things worth knowing before you start

- `GET /api/mytvchannel/users/status.php` is the right first call. It returns the owner's tier,
  real quota limits, and for every channel exactly what it still needs before it can go live.
- **You cannot upload a local file over MCP.** Tool arguments are JSON; there is no multipart
  channel. Use `import_video_from_url` with a direct, public, unauthenticated media URL. Files
  on someone's laptop have to go through the app.
- **A channel launches by itself** once it has ≥4 ready videos and ≥15 minutes of content.
  Transcoding is the slow step; poll `assets/status.php`.
- **Set each video's weight as it becomes ready, not at the end.** The schedule is built at the
  instant the channel crosses the launch threshold, from the weights present then. Weights set
  later are stored but never air until `schedule/regenerate.php` is called.
- Responses are always `{"success": true, "data": ...}` or
  `{"success": false, "error": "...", "code": N}` — with one exception:
  `channels/schedule.php` returns `data` as a bare array.
- Rate limit: 1,000 requests/hour per key, then HTTP 429 with `Retry-After`.

## Product

- [Home](https://my-tv-channel.com/): what the product is, the platforms it runs on, and pricing.
- [FAQ](https://my-tv-channel.com/faq/)
- [Advertisers](https://my-tv-channel.com/advertisers/): free-to-air channels, 0% commission.
- [Pause ads](https://my-tv-channel.com/pause-ads/): what a pause ad is, the specs per platform,
  and which of the widely-quoted statistics actually hold up.

## Optional

- [Pay per view](https://my-tv-channel.com/pay-per-view/)
- [Self-hosting HLS on a budget](https://my-tv-channel.com/self-host-broadcast/)
- [Putting a TV channel in a Discord server](https://my-tv-channel.com/how-to-discord-tv-channel/)
- [Privacy](https://my-tv-channel.com/privacy.html) ·
  [Terms](https://my-tv-channel.com/terms.html)