Skip to main content
Feedback

TVmaze MCP connector

TVmaze is a comprehensive database and API for television shows, episodes, schedules, and cast information. The TVmaze MCP connector allows AI agents to authenticate users, track watched and acquired episodes, and manage episode markers for individual shows. It also supports retrieving TV show metadata, episode details, and broadcast schedules to help users organize their viewing history.

Authentication type

  • Basic Auth - Requires a username and password to be configured for the agent to access the service.

Uses

Use the TVmaze MCP connector to perform the following actions:

  • Track TV show viewing habits and automatically mark episodes as watched across your entertainment portfolio
  • Monitor premiere dates and schedule alerts for new episodes from your favorite networks and shows
  • Build personalized entertainment catalogs by following shows, networks, people, and webchannels
  • Organize and tag TV content collections to streamline content discovery and viewing workflows
  • Synchronize episode acquisition records with your media management systems in real time
  • Generate reports on watched and acquired episodes to audit your content library and viewing patterns
  • Validate TV show metadata and episode information to maintain accurate entertainment databases

Example prompts

Use the following example prompts to invoke TVmaze MCP connector tools from your AI assistant or Boomi Connect workflow:

  • Show me all the shows I follow in TVmaze and their upcoming episode schedules.
  • Mark episodes 5 through 12 of season 2 as watched in TVmaze.
  • Create a tag called "Sci-Fi Classics" in TVmaze and list all my tagged shows.
  • Which networks am I currently following in TVmaze.
  • Unmark episode 3 of The Office in TVmaze and check if it's still marked.
  • Add a new tag in TVmaze called "Weekend Binges" and show all my existing tags.
  • List all episodes I've marked as acquired in TVmaze across all shows.
  • Follow the HBO network in TVmaze and check if I'm already following Netflix.
  • Verify my TVmaze login credentials are valid.
  • Delete the tag "On Hold" from my TVmaze account and show remaining tags.

TVmaze MCP connector tools

The TVmaze MCP connector provides the following tools. Each tool maps to a specific action you can invoke from your AI agent or automation.

ToolDescription
createAuthPollChecks whether a pending authentication request has been confirmed by the user.
createAuthStartInitiates a new authentication request for user account access.
getAuthValidateVerifies that your current authentication credentials are valid and active.
createScrobbleEpisodesMarks multiple episodes as watched or acquired based on their identifiers.
updateScrobbleEpisodesMarks a single episode as watched or acquired by its identifier.
createScrobbleShowsMarks episodes within a show as watched or acquired by their attributes.
getScrobbleShowsRetrieves a list of watched and acquired episodes for a specific show.
getUserEpisodesDisplays all episodes marked as watched or acquired by the user.
deleteUserEpisodesRemoves a mark from an episode, clearing its watched or acquired status.
getUserEpisodes2Determines whether a specific episode has been marked by the user.
updateUserEpisodesMarks an episode as watched or acquired for the user account.
getUserFollowsNetworksDisplays all networks the user is currently following.
deleteUserFollowsNetworksStops following a network and removes it from the user's list.
getUserFollowsNetworks2Checks whether the user is following a specific network.
updateUserFollowsNetworksAdds a network to the user's follow list.
getUserFollowsPeopleDisplays all people the user is currently following.
deleteUserFollowsPeopleStops following a person and removes them from the user's list.
getUserFollowsPeople2Checks whether the user is following a specific person.
updateUserFollowsPeopleAdds a person to the user's follow list.
getUserFollowsShowsDisplays all shows the user is currently following.
deleteUserFollowsShowsStops following a show and removes it from the user's list.
getUserFollowsShows2Checks whether the user is following a specific show.
updateUserFollowsShowsAdds a show to the user's follow list.
getUserFollowsWebchannelsDisplays all webchannels the user is currently following.
deleteUserFollowsWebchannelsStops following a webchannel and removes it from the user's list.
getUserFollowsWebchannels2Checks whether the user is following a specific webchannel.
updateUserFollowsWebchannelsAdds a webchannel to the user's follow list.
getUserTagsRetrieves all tags created by the user for organizing content.
createUserTagsCreates a new custom tag for organizing and categorizing content.
deleteUserTagsRemoves a specific tag from the user's collection.
patchUserTagsUpdate a specific tag.
getUserTagsShowsList all shows under this tag.
deleteUserTagsShowsUntag a show.
updateUserTagsShowsTag a show.
getUserVotesEpisodesList the episodes voted for.
deleteUserVotesEpisodesRemove an episode vote.
getUserVotesEpisodes2Check if an episode is voted for.
updateUserVotesEpisodesVote for an episode.
getUserVotesShowsList the shows voted for.
deleteUserVotesShowsRemove a show vote.
getUserVotesShows2Check if a show is voted for.
updateUserVotesShowsVote for a show.
On this Page