Get started
Open the web app in a browser with WebMCP enabled, then ask its assistant: “Find a podcast about design and play an episode.” Tools are registered while the player app is open, including shared show and episode pages.
Knots uses the experimental document.modelContext API. Browser and assistant support varies. Browsers without it can still use all normal app controls. This reference page does not register playback tools.
No API key or MCP server URL is needed. For integration details, see the Chrome WebMCP documentation.
Available tools
Search first, pass a result’s feedUrl as feedURL to list episodes, then pass an episode’s id as episodeID to play it. Playback requests may need a user gesture; check playback status to confirm audio has started.
To manage shows, use the podcast ID returned by knots_list_episodes to follow a show, or list followed shows to unfollow one. List favorites to see saved shows and episodes, then set saved to true or false to add or remove one. Following and favorites are independent.
Queue an episode to play next or last, remove an episode, or clear upcoming playback. List the queue before reordering: use unit IDs to move whole groups and individual episodes, or supply a group ID with episode IDs to reorder inside a group. Queue edits do not interrupt the current episode.
knots_search_podcasts
Search podcasts. Returns show metadata and feedUrl values for knots_list_episodes.
Read-only tool. May populate the local catalog cache.
Input schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Podcast title, author, or topic",
"maxLength": 200
}
},
"required": [
"query"
],
"additionalProperties": false
}knots_list_episodes
Load a podcast RSS feed and return up to 50 episodes with IDs usable by knots_play_episode. Does not follow the show.
Read-only tool. May populate the local catalog cache.
Input schema
{
"type": "object",
"properties": {
"feedURL": {
"type": "string",
"minLength": 1,
"description": "HTTP or HTTPS podcast feedUrl returned by search"
}
},
"required": [
"feedURL"
],
"additionalProperties": false
}knots_get_playback
Read the current episode, playback state, position and duration in seconds.
Read-only tool. May populate the local catalog cache.
Input schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}knots_play_episode
Request playback of an episode ID previously returned by knots_list_episodes in this tab. Updates listening history and removes the episode from the queue. Browser autoplay restrictions may require a user gesture; use knots_get_playback to check actual playback.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {
"episodeID": {
"type": "string",
"minLength": 1,
"description": "Episode ID from knots_list_episodes"
}
},
"required": [
"episodeID"
],
"additionalProperties": false
}knots_control_playback
Pause or resume the current episode. Resume requests playback; check knots_get_playback for the actual state.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"pause",
"resume"
]
}
},
"required": [
"action"
],
"additionalProperties": false
}knots_seek
Seek the current episode to an absolute position in seconds. Updates saved listening progress.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {
"seconds": {
"type": "number",
"minimum": 0
}
},
"required": [
"seconds"
],
"additionalProperties": false
}knots_list_shows
List followed shows with podcastID, title, author and feedURL. Uses the current library, including synced shows not yet in the catalog.
Read-only tool. May populate the local catalog cache.
Input schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}knots_set_show_followed
Follow or unfollow a show. Use podcastID from knots_list_episodes or knots_list_shows. Set followed explicitly; repeated requests do not toggle. Unfollowing preserves favorites and listening history. Changes follow existing sync settings.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {
"podcastID": {
"type": "string",
"minLength": 1,
"description": "Knots podcast ID, not an Apple search ID"
},
"followed": {
"type": "boolean"
}
},
"required": [
"podcastID",
"followed"
],
"additionalProperties": false
}knots_list_favorites
List favorite shows and episodes, including saved metadata and IDs. Does not require downloading feeds.
Read-only tool. May populate the local catalog cache.
Input schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}knots_set_favorite
Add or remove a show or episode favorite. Use kind show with a podcast ID or kind episode with an episode ID from knots_list_episodes, knots_list_shows or knots_list_favorites. Set saved explicitly; repeated requests do not toggle. Does not change following or playback. Changes follow existing sync settings.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"show",
"episode"
]
},
"id": {
"type": "string",
"minLength": 1,
"description": "Knots show or episode ID"
},
"saved": {
"type": "boolean"
}
},
"required": [
"kind",
"id",
"saved"
],
"additionalProperties": false
}knots_list_queue
List the upcoming queue in playback order, including episode references and unit IDs. A unit is one episode or a group of episodes. Does not include the currently playing episode unless separately queued.
Read-only tool. May populate the local catalog cache.
Input schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}knots_enqueue_episode
Add an episode to play next or last without starting playback. Use an episode ID from loaded episodes, favorites, or the queue. An existing entry is moved instead of duplicated and removed from its previous group. Changes follow existing sync settings.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {
"episodeID": {
"type": "string",
"minLength": 1,
"description": "Knots episode ID"
},
"position": {
"type": "string",
"enum": [
"next",
"last"
]
}
},
"required": [
"episodeID",
"position"
],
"additionalProperties": false
}knots_remove_queue_episode
Remove an episode from the upcoming queue by ID. Repeating removal is harmless. Does not stop current playback or remove favorites.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {
"episodeID": {
"type": "string",
"minLength": 1,
"description": "Episode ID from knots_list_queue"
}
},
"required": [
"episodeID"
],
"additionalProperties": false
}knots_reorder_queue
Reorder the upcoming queue. Without groupID, orderedIDs contains unit IDs from knots_list_queue; groups stay intact. With groupID, orderedIDs contains episode IDs within that group. Listed IDs move to the front in the given order; omitted entries retain their relative order. Read the queue again if an ID is stale.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {
"orderedIDs": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"description": "Unit ID, or episode ID when groupID is supplied"
},
"minItems": 1,
"uniqueItems": true
},
"groupID": {
"type": "string",
"minLength": 1,
"description": "Optional group ID from knots_list_queue"
}
},
"required": [
"orderedIDs"
],
"additionalProperties": false
}knots_clear_queue
Remove every episode from the upcoming queue. Does not stop the current episode or erase listening history or favorites. Changes follow existing sync settings.
Changes playback or your library.
Input schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}Your data stays in your session
Tools use the same catalog and player as the app. Search and feed loading make the normal catalog requests. Playback can update listening history and the queue. Following and favorites tools update your library. All changes follow your existing sync settings.
These tools do not expose account credentials, purchases, account deletion, or library erasure. Podcast titles and feed metadata come from external publishers and should be treated as untrusted content.