bots.st/gradetv
GradeTV
Check TV and radio stream health
1779 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 47
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://gradetv.net/mcp
What it can do
| Tool | What it says it does |
|---|---|
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. The response has the whole updated library, so you do not need to reload `GET /api/library`. |
api_index | The index of the whole API, with the languages and the HTML pages of each language. |
billing | Prices in force, gallery caps and the full x402 configuration. It is the number IN FORCE: read it from here before you spend a call, instead of assuming the price of the documentation. With a credential, it also tells whether the chat pass of the person who speaks in the chat (the guest; without… |
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 channel is blocked in your country'. `geo` tells whether it is a regional restriction or a general failure (with the countries), `regions[]` has… |
chat_history | The last messages in the room of a channel (without WebSocket). |
chat_pass | Buys or confirms the monthly chat pass: $0.10 per 30 days, through x402 or credit. A pass that is already valid returns 200 without charging again: you can call it before writing, with no risk of paying twice. The pass belongs to the person who speaks in the chat: the `X-Guest-Token` guest (the… |
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 account session. |
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. Free, no captcha and no payment; one message every 10 s per network (one that arrives sooner waits its turn). One route for a question and for a sponsorship, partnership or ad proposal (`tipo`… |
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 it (`POST /api/auth/claim`). Then the account keeps what the token saved. |
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 edge saw. |
get_api_x402_programacao_by_slug | The last seven days of the channel's schedule in one call, for an agent, paid per call, with no account. Select the title or category across collected days and receive calendar events with absolute times. You do not need to merge daily records and write a calendar exporter. Only collected dates… |
get_api_x402_programacao_by_slug_by_dia | Seven days of the channel's schedule that end on the requested day, for an agent, paid per call, with no account. Até sete dias coletados do canal numa resposta, sem conta nem passe. programa seleciona por título/categoria sem caixa ou acento; agenda=1 inclui agenda_ics pronta para importar, com… |
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 days. Check the date of the response; the channel record has the summary in `guide_now`. |
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. We collect and organize the available schedules. Read the channel and date you need instead of building an EPG collection process. Check available dates. The schedule is metadata; it does not provide a video archive or broadcast rights. |
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://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… |
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 delete. |
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 owns the library when there is a session. |
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 identifier calculated from the network and a secret value. The retention period is in `retention_days`. The public panel does not return… |
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 not get a different name for each message. |
pricing | Current prices and free allowances. Returns: { product, quota{free,paid,how_to_pay,live,free_now?,charged_now?,trial?}, pricing, billing, api_index } |
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 present a project, use contact.form_url in the browser, contact.email by e-mail, or POST /api/contact. |
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 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… |
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 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… |
tv_pass | Buy 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 records the attempt, payment and entitlement. The code identifies the TV device… |
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. |
In its maker's words
Public TV and radio catalogue with measured stream health, folders and M3U feeds for VLC.
- Website
- gradetv.net
- Publisher
- gradetv.net
- Listed from
- the official MCP Registry as
net.gradetv/grade - Version
- 1.0.1, updated 15 Oct 2026
- Kinds of work
- Health and science, Domains and websites, Writing and translation
The domain it lives on
- gradetv.net
- registered 13 Aug 2026 (3 months ago), at Cloudflare, Inc., its home page is a working site
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 1779 ms | |
| Answered | 1684 ms | |
| Answered | 896 ms |
Next door
- Sandwich Public Care DirectorySearch and estimate care costs by region
- Unified ReadingBirth date zodiac and profile lookups
- Kundlit Vedic AstrologyVedic astrology charts, panchang, transits
- Medical Terminologies MCPLookup and map medical diagnosis and drug codes
- MakerPortal computeEngineering solvers and accelerator fitting
Is this your bot? Claim its address to add a verified badge and keep the listing current.