MCP server

GradeTV Official

net.gradetv/grade

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Public TV and radio catalogue with measured stream health, folders and M3U feeds for VLC.

Website

At a glance

Type

MCP server

Publisher

gradetv.net (verified by the MCP Registry)

Status

Working at last check

Tools

41

Token cost

About 5,742 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.grade]
url = "https://gradetv.net/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add grade https://gradetv.net/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"grade","server_url":"https://gradetv.net/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"grade","server_url":"https://gradetv.net/mcp"}

Tools

• add_favorite ~92 tokens
  Marks a channel as a favorite. A repeat does not add up: the public counter counts people, not clicks.
• add_item ~160 tokens
  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. The response has the whole updated library, so you do not need to reload `GET /api/library`.
• api_index ~49 tokens
  The index of the whole API, with the languages and the HTML pages of each language.
• channel_health ~211 tokens
  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 channel is blocked in your country'. `geo` tells whether it is a regional restriction or a general failure (with the countries), `regions[]` has t
• chat_history ~80 tokens
  The last messages in the room of a channel (without WebSocket).
• chat_send Sends messages · ~166 tokens
  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 account session.
• clear_history ~39 tokens
  Clears the whole history of the owner at once.
• contact ~874 tokens
  Write to the people behind the product: a question, or a sponsorship/partnership/advertising proposal. One route for a question and for a sponsorship, partnership or ad proposal (`tipo`, with the placements of `GET /api/partners`). One message every 10 seconds per network: one that arrives sooner wa
• create_category ~99 tokens
  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 ~123 tokens
  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 ~93 tokens
  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 it (`POST /api/auth/claim`). Then the account keeps what the token saved.
• delete_comment Deletes data · ~91 tokens
  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 ~77 tokens
  Removes a channel from the owner's history.
• geo ~71 tokens
  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 edge saw.
• get_channel ~79 tokens
  The full record of a channel, with the streams that already point to our hop.
• get_channel_guide ~130 tokens
  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 days. Check the date of the response; the channel record has the summary in `guide_now`.
• get_history ~118 tokens
  The channels that the owner watched. It shows only the channels that are available in the catalog.
• get_library ~51 tokens
  The whole library of the owner: folders, tabs, channels and the feed URLs of each level.
• get_programacao ~113 tokens
  The last TV guide available for the channel and up to 20 dates of its history.
• get_programacao_dia ~125 tokens
  The stored TV guide of a channel on one day.
• health ~50 tokens
  Liveness and the commit that is published now. The smoke test waits for its own deploy here.
• legacy_stream ~210 tokens
  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://legacy.gradetv.net/legacy?stream=ID, with no port in the address. The standalone page accepts lang=pt/en/es/fr/de/hu and theme=light/dark. Pla
• list_cities ~98 tokens
  The cities that have a playable channel. You can filter them by country and by state.
• list_comments ~105 tokens
  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 delete.
• list_countries ~104 tokens
  The countries in the catalog, with the playable count and the flag URL (`kind=radio` counts stations).
• list_favorites ~52 tokens
  The favorites of the owner. It shows only the channels that are available in the catalog.
• list_languages ~48 tokens
  The languages that have a playable channel, with the count of each language.
• list_networks ~48 tokens
  The networks and broadcasters that have a playable channel, with the count.
• list_programacao ~104 tokens
  Channels with a collected TV guide, up to 48 per page.
• list_qualities ~53 tokens
  The different qualities found in the catalog streams (for radio, the codec and the bitrate).
• list_subdivisions ~67 tokens
  The states and provinces that have a playable channel.
• list_tags ~104 tokens
  The tags of the playable radio stations, with the count, optionally by country.
• me ~80 tokens
  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 owns the library when there is a session.
• play_reports ~199 tokens
  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 identifier calculated from the network and a secret value. The retention period is in `retention_days`. The public panel does not return thi
• post_comment Sends messages · ~176 tokens
  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 not get a different name for each message.
• producer_services ~156 tokens
  Authorized 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, contact.email by e-mail, or POST /api/contact.
• record_watch ~74 tokens
  Records a watched channel in the owner's history.
• remove_favorite ~91 tokens
  Removes the channel from the favorites and gives the point back to the public counter.
• report_play ~284 tokens
  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 request data; the body cannot change them. The first report of a result on a day returns 201. It counts once per owner, channel, day and result;
• search_channels ~697 tokens
  Searches 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 by the radio votes; online=1 returns only channels seen online in the last 48 h).
• tv_state ~101 tokens
  Checks the TV device's activation by its six-digit code. The network is the fallback for clients without a playback cookie or UUID.

Browse

• Email
• Advertising

Related MCP servers

• Escola de Rádio TV & Web (ER+)
  Cursos, turmas, vagas, professores, podcasts e blog da Escola de Rádio (ER+) — read-only.
• Bizzy Radio
  Find Bizzy radio stations, read station cards and public author information. Read-only; no playback.
• Taifoon coordination layer
  Start here: a free key in one call, then a demand in words that is hired, graded and settled
• Mappit
  The world's news on a live map: place briefings, storylines, statistics, live layers, businesses.
• Robinx
  Robinhood Chain MCP server: rug checks, deployer records, measured X callers. For agents and bots.
• Canarics Radio
  24/7 AI-hosted radio (LV+EN). Agents read transcripts and ask the hosts questions answered on air.
• GuideDoc Documentary Database
  Search public documentary film reference pages and check which titles stream on GuideDoc.
• Honestdog
  Vetted German dog-breeder directory, S-E breed health grades and tests, adoptable shelter dogs

Badge for your README

[![AptLynx](https://aptlynx.net/badge/net.gradetv/grade.svg)](https://aptlynx.net/servers/net.gradetv/grade)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents