# Watchmode

> Watchmode is a freemium MCP server for maps and travel. MCP server for looking up where movies and TV shows stream, via the Watchmode API. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/watchmode
- **Repository:** https://github.com/pipeworx-io/mcp-watchmode
- **MCP Registry name:** io.github.pipeworx-io/watchmode
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

The README says this is an unofficial, independent integration that wraps the Watchmode streaming availability API and exposes it to MCP clients through the Pipeworx gateway. Rather than a single lookup, it offers a set of tools that move from searching titles to pulling metadata, streaming sources by region, seasons and episodes, and catalog browsing with filters for source, genre, network, and release dates.

The typical flow starts with a title search that returns Watchmode title IDs, then uses those IDs for detail, source, or season queries. Directory tools for sources, networks, genres, and regions supply the IDs needed to filter catalog and release queries. Pricing and regional availability are returned per service, with subscription, rent, or buy type.

It suits developers and assistants that need streaming availability data inside an AI workflow. Anonymous use is capped daily, and the README notes a free key raises the limit.

## Features

- **Title search:** Finds movies and TV shows by name or by IMDb or TMDb ID, with optional type filtering.
- **Streaming availability by region:** Lists which services carry a title in which countries, with subscription, rent, or buy type and price.
- **Title metadata:** Returns title details such as year, genres, plot, runtime, rating, and cast.
- **Seasons and episodes:** Enumerates seasons and episode counts for TV series.
- **Catalog and release browsing:** Filters the title catalog and recent or upcoming releases by source, genre, network, type, and date range.
- **Reference directories:** Provides lists of streaming sources, networks, genres, and supported regions to use as filter IDs.

## Good for

- Checking which streaming services carry a given movie in a specific country
- Tracking new or upcoming additions to a streaming service
- Building a recommendation assistant that filters titles by genre and network
- Looking up cast, runtime, and ratings for a title inside an AI chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http watchmode https://gateway.pipeworx.io/watchmode/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/watchmode/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "watchmode": {
      "url": "https://gateway.pipeworx.io/watchmode/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "watchmode": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/watchmode/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "watchmode": {
      "serverUrl": "https://gateway.pipeworx.io/watchmode/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "watchmode": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/watchmode/mcp"
    }
  }
}
```

## Tools

- `title_search`: Search titles by name or IMDb/TMDb ID
- `title_detail`: Fetch full metadata for a title
- `title_sources`: Streaming sources for a title by region
- `title_seasons`: Seasons and episodes for a TV show
- `releases`: Recent and upcoming streaming releases
- `list_titles`: Browse and filter the title catalog
- `sources`: List streaming sources and services
- `networks`: List TV networks
- `genres`: List movie and TV genres
- `regions`: List supported regions
- `languages`: List supported languages

## FAQ

### Do I need an API key to use it?

The registry entry says the key is optional. Without it, calls are anonymous and capped daily; a free Pipeworx key raises the cap.

### Which upstream data source does it use?

It wraps the Watchmode streaming availability API, which the README says covers 200+ services.

### Is it affiliated with Watchmode?

No. The README states it is an independent, unofficial integration.

### Is Watchmode free?

Watchmode has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Watchmode to Claude Code?

Run this command in your terminal: claude mcp add --transport http watchmode https://gateway.pipeworx.io/watchmode/mcp

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Europe Rail Watch MCP](https://ai-powered.com/mcp/europe-rail-watch-mcp): Europe Rail Watch MCP is a paid MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/watchmode
