# GradeTV

> GradeTV is a freemium MCP server for tv and radio guides. Search TV channels and radio stations and read today's guide from an assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://gradetv.net
- **Repository:** https://github.com/wrpbr/gradetv
- **MCP Registry name:** net.gradetv/grade
- **Categories:** tv and radio guides
- **Listing updated:** 2026-11-14

## About

The server is hosted at gradetv.net and talks Streamable HTTP, so nothing runs on your machine. Each channel record carries its streams, how often they play and the reasons they fail, which lets an assistant answer questions like which Brazilian news channels are working right now.

A person can also keep channels in personal folders and play them in the browser or in VLC through a stable M3U feed. The connection used in the setup examples disables payment transactions through the assistant, so any paid step, such as the TV pass for watching on a television, is completed on the website.

The README notes that GradeTV lists streams published by broadcasters and public lists and does not grant rights to the content. The repository holds connection settings and a user skill under the MIT-0 license; the hosted service has its own terms and is not open source.

## Features

- **Channel and radio search:** Looks up public TV channels and radio stations by name or topic.
- **Stream health:** Shows the play rate and failure reasons for a channel's streams.
- **Daily TV guide:** Reads today's guide for a channel when one is available.
- **Personal library:** Keeps channels in folders and gives feed URLs, with no account needed to start.
- **M3U feed for VLC:** Exposes a stable playlist feed for playback outside the browser.

## Good for

- Find news channels that are currently playing
- Check why a stream keeps failing before sharing it
- Build a personal list of radio stations and open it in VLC
- Look up what a channel airs today

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http grade https://gradetv.net/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gradetv.net/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "grade": {
      "url": "https://gradetv.net/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "grade": {
      "type": "http",
      "url": "https://gradetv.net/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "grade": {
      "serverUrl": "https://gradetv.net/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "grade": {
      "type": "http",
      "url": "https://gradetv.net/mcp"
    }
  }
}
```

## Tools

- `search_channels`: Searches channels and radio stations.
- `get_channel`: Reads one channel and its streams.
- `channel_health`: Reads the play rate and failure reasons.
- `get_channel_guide`: Reads today's TV guide.
- `create_guest`: Creates a guest identity for a personal library.
- `get_library`: Reads the personal library.
- `add_item`: Adds a channel to the personal library.

## FAQ

### Do I need an account to browse?

No. The README says browsing the catalog, guides and personal library needs no account and costs nothing.

### What does it cost to watch on a TV?

Watching on a TV set uses a paid TV pass, bought on the website rather than through the assistant.

### Which clients can connect?

Any client that supports Streamable HTTP; the README shows VS Code with GitHub Copilot and Cursor.

### Does GradeTV give rights to the streams?

No. It lists streams that broadcasters and public lists publish and grants no rights to the content.

### Is GradeTV free?

GradeTV has a free plan, with paid plans for more usage or features.

### How do I add GradeTV to Claude Code?

Run this command in your terminal: claude mcp add --transport http grade https://gradetv.net/mcp

### What are the best alternatives to GradeTV?

The closest alternatives to GradeTV are Static Radio, StreamPick, GlobeNow.tv live news and TV, OndaCast and timezone.football.

## Alternatives

- [Static Radio](https://ai-powered.com/mcp/static-radio): Static Radio is a free MCP server for tv and radio guides.
- [StreamPick](https://ai-powered.com/mcp/streampick): StreamPick is a free MCP server for tv and radio guides.
- [GlobeNow.tv live news and TV](https://ai-powered.com/mcp/globenow-tv-live-news-and-tv): GlobeNow.tv live news and TV is a free MCP server for news and media.
- [OndaCast](https://ai-powered.com/mcp/ondacast): OndaCast is a free MCP server for tv and radio guides.
- [timezone.football](https://ai-powered.com/mcp/timezone-football): timezone.football is a free MCP server for sports data.
- [StreamRank](https://ai-powered.com/mcp/streamrank): StreamRank is a freemium MCP server for tv and radio guides.
- [Cadena Láser — noticias y radios de Río Tercero](https://ai-powered.com/mcp/cadena-laser-noticias-y-radios-de-rio-tercero): Cadena Láser — noticias y radios de Río Tercero is a free MCP server for news and media.

---
Source: https://ai-powered.com/mcp/gradetv
