# Gradetv Grade MCP server

Source: https://glimind.com/server/mcp-registry%2Fnet.gradetv%2Fgrade
Registry id: `mcp-registry/net.gradetv/grade`
Status: live (checked 2026-10-26T19:50:42.140Z)

## Measurements (30 days)

- Uptime: 99.91%
- Checks: 4915
- Outages (90 days): 4

## Install

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

Claude Code:

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

## Tools (41)

- `add_favorite`: Marks a channel as a favorite. A repeat does not add up: the public counter counts people, not clicks.
- `add_item`: Adds a channel to a tab. 40 channels at most per tab. The response tells the folder and the tab where the channel went, so the screen opens in the right place. 
- `api_index`: The index of the whole API, with the languages and the HTML pages of each language.
- `channel_health`: The community health of the channel: the success rate, the failure reasons and the affected environments. It tells 'the channel is off the air' from 'the channe
- `chat_history`: The last messages in the room of a channel (without WebSocket).
- `chat_send`: Sends a message to the room of a channel by HTTP. The speaker is the guest (`X-Guest-Token`), the same one that the WebSocket recognizes; without a guest, the a
- `clear_history`: Clears the whole history of the owner at once.
- `contact`: Write to the people behind the product: a question, or a sponsorship/partnership/advertising proposal. One route for a question and for a sponsorship, partnersh
- `create_category`: Creates a personal folder (category). 8 folders at most per owner. The response has the whole updated library, so you do not need to reload `GET /api/library`.
- `create_group`: Creates a tab in a folder. 12 tabs at most per folder. The response has the whole updated library, so you do not need to reload `GET /api/library`.
- `create_guest`: Creates a guest `ipt_…`. It asks for no e-mail and no other data. Keep the token: if you lose the token, you lose the library, unless an account already claimed
- `delete_comment`: Deletes a comment of the owner. The 404 is on purpose: the API does not confirm that a comment with that id exists when it is not yours.
- `forget_watch`: Removes a channel from the owner's history.
- `geo`: The country and the language suggested for the caller. When the edge detects no country, it suggests BR with `source: "fallback"`; `detected` tells what the edg
- `get_channel`: The full record of a channel, with the streams that already point to our hop.
- `get_channel_guide`: Today's TV guide of the channel (recorded by us): now, next and the list. It is available for the channels with a guide (`guide=1`) and is valid for up to two d
- `get_history`: The channels that the owner watched. It shows only the channels that are available in the catalog.
- `get_library`: The whole library of the owner: folders, tabs, channels and the feed URLs of each level.
- `get_programacao`: The last TV guide available for the channel and up to 20 dates of its history.
- `get_programacao_dia`: The stored TV guide of a channel on one day.
- `health`: Liveness and the commit that is published now. The smoke test waits for its own deploy here.
- `legacy_stream`: Public metadata: the official site of the channel, the stream URL to copy into another player, and the legacy HTTP player. The legacy_url button opens http://le
- `list_cities`: The cities that have a playable channel. You can filter them by country and by state.
- `list_comments`: The community comments about a channel. When the call has a credential, each of your comments has `mine: true`; this is how the interface knows what you can del
- `list_countries`: The countries in the catalog, with the playable count and the flag URL (`kind=radio` counts stations).
- `list_favorites`: The favorites of the owner. It shows only the channels that are available in the catalog.
- `list_languages`: The languages that have a playable channel, with the count of each language.
- `list_networks`: The networks and broadcasters that have a playable channel, with the count.
- `list_programacao`: Channels with a collected TV guide, up to 48 per page.
- `list_qualities`: The different qualities found in the catalog streams (for radio, the codec and the bitrate).
- `list_subdivisions`: The states and provinces that have a playable channel.
- `list_tags`: The tags of the playable radio stations, with the count, optionally by country.
- `me`: The session account (the cookie that the MCP client passes on): the e-mail and the size of the account library. `user.id` is the account id, and the account own
- `play_reports`: The raw reports of a channel, with the address. Operator only (METRICS_TOKEN). Use it to investigate one channel. In the current reports, the `ip` field has an 
- `post_comment`: Comments on a channel (20 per hour at most per owner). Without `author`, the server makes a nickname that stays the same for the same owner, so the person does 
- `producer_services`: Authorized broadcast offer on request: information and contacts for producers. It does not turn on streams; it only gives information and collects interest. To 
- `record_watch`: Records a watched channel in the owner's history.
- `remove_favorite`: Removes the channel from the favorites and gives the point back to the public counter.
- `report_play`: Reports whether a channel played (ok=true) or not (ok=false with code). The browser and the system come from the User-Agent, and the country comes from the requ
- `search_channels`: Searches public channels (filters: q, country, category, language, network, quality, playable; kind=radio for radio stations, tag for a radio tag; sort=score or
- `tv_state`: Checks the TV device's activation by its six-digit code. The network is the fallback for clients without a playback cookie or UUID.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.