Skip to content
MCP server

GradeTV

Search TV channels and radio stations and read today's guide from an assistant

Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.1.0
Listing updated
3 days ago

About GradeTV

GradeTV is a freemium MCP server for tv and radio guides. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gradetv.net/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "grade": {
      "url": "https://gradetv.net/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Browsing, guides and the library are free; the TV pass for watching on a TV is paid; prices not published

Prices change. Check gradetv.net before you buy.

GradeTV 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 to GradeTV

  1. Static Radio

    MCP server

    Ask an assistant what is on now and next across Static Radio's live stations

    Not checked yet
    • 5 tools
    • Remote
    • Free
    • Tv and radio guides
  2. StreamPick

    MCP server

    Where to watch in South Korea: OTT availability, cheapest plans and trending titles

    Not checked yet
    • 6 tools
    • Remote
    • Free
    • Tv and radio guides
  3. Ask about a city's latest news videos or start a free live TV channel in chat

    Not checked yet
    • 2 tools
    • Remote
    • Free
    • News and media
  4. OndaCast

    MCP server

    Search live radio stations, podcasts, audiobooks and song charts from an AI assistant

    Not checked yet
    • Remote
    • Free
    • Tv and radio guides
  5. Where to watch football by country, with kickoff in your time zone and verified prices

    Not checked yet
    • Remote
    • Free
    • Sports data
  6. StreamRank

    MCP server

    Daily streaming Top 10s by country and service, plus breakout pick forecasts

    Not checked yet
    • Remote
    • Freemium
    • Tv and radio guides