GradeTV

Connect it to your AI

Claude Code

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

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://gradetv.net/mcp

Cursor, VS Code and other apps (mcp.json)

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

Tools it offers

47 tools, as the server itself reported during our check on Oct 31, 2026.

• list_programacaoChannels with a collected TV guide, up to 48 per page.
• get_programacaoThe last TV guide available for the channel and up to 20 dates of its history.
• get_programacao_diaThe stored TV guide of a channel on one day.
• api_indexThe index of the whole API, with the languages and the HTML pages of each language.
• healthLiveness and the commit that is published now. The smoke test waits for its own deploy here.
• geoThe country and the language suggested for the caller. When the edge detects no country, it suggests BR with `source: "fallback"`; `detected` tells what the edge saw.
• list_countriesThe countries in the catalog, with the playable count and the flag URL (`kind=radio` counts stations).
• list_tagsThe tags of the playable radio stations, with the count, optionally by country.
• search_channelsSearches public channels (filters: q, country, category, language, network, quality, playable; kind=radio for radio stations, tag for a radio tag; sort=score orders by the health that a third party measures, sort=votes b
• list_languagesThe languages that have a playable channel, with the count of each language.
• list_networksThe networks and broadcasters that have a playable channel, with the count.
• list_qualitiesThe different qualities found in the catalog streams (for radio, the codec and the bitrate).
• list_subdivisionsThe states and provinces that have a playable channel.
• list_citiesThe cities that have a playable channel. You can filter them by country and by state.
• get_channelThe full record of a channel, with the streams that already point to our hop.
• get_channel_guideToday'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 days. Check the date of the response; the channel record has
• create_guestCreates 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 it (`POST /api/auth/claim`). Then the account keeps what th
• get_libraryThe whole library of the owner: folders, tabs, channels and the feed URLs of each level.
• create_categoryCreates 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_groupCreates 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`.
• add_itemAdds 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. The response has the whole updated library, so you do not ne
• get_historyThe channels that the owner watched. It shows only the channels that are available in the catalog.
• record_watchRecords a watched channel in the owner's history.
• forget_watchRemoves a channel from the owner's history.
• clear_historyClears the whole history of the owner at once.
• tv_stateChecks the TV device's activation by its six-digit code. The network is the fallback for clients without a playback cookie or UUID.
• tv_passBuy a TV pass for 2 devices: 0.10 USDC for 30 days, 0.29 for 90 or 0.99 for 365. No automatic renewal. A 402 uses x402 on Base; repeat the same call with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1). The shared ledger record
• legacy_streamPublic 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://legacy.gradetv.net/legacy?stream=ID, with no port in the addre
• producer_servicesAuthorized broadcast offer on request: information and contacts for producers. It does not turn on streams; it only gives information and collects interest. To present a project, use contact.form_url in the browser, cont
• report_playReports 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 request data; the body cannot change them. The first report of a
• play_reportsThe 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 identifier calculated from the network and a secret value. T
• channel_healthThe 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 channel is blocked in your country'. `geo` tells whether it is a r
• list_favoritesThe favorites of the owner. It shows only the channels that are available in the catalog.
• add_favoriteMarks a channel as a favorite. A repeat does not add up: the public counter counts people, not clicks.
• remove_favoriteRemoves the channel from the favorites and gives the point back to the public counter.
• list_commentsThe 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 delete.
• post_commentComments 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 not get a different name for each message.
• delete_commentDeletes 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.
• chat_historyThe last messages in the room of a channel (without WebSocket).
• chat_sendSends 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 account session.

Questions