home / mcp / usher mcp server

Usher MCP Server

MCP App that returns movie details

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "khandrew1-usher-mcp": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "TMDB_TOKEN": "YOUR_TMDB_TOKEN"
      }
    }
  }
}

You deploy and run an MCP server that serves a movie detail widget powered by TMDB. This server exposes a UI resource and a tool to fetch movie details and cast, enabling MCP hosts to render rich movie information in apps and widgets with minimal setup.

How to use

You interact with the Usher MCP server through an MCP-compatible client. Start the local development server to run the MCP endpoint and the UI widget, then use the get-movie-detail tool to search TMDB by movie title and retrieve structured movie data including cast information. You can open a showtimes link through the widget, which will launch a browser search for showtimes near you.

How to install

Prerequisites include Node.js version 18 or newer, the Wrangler CLI, and a TMDB API token stored as a secret.

Step-by-step commands you will run locally to install and start the server:

1) Install dependencies for the project.

npm install

2) Create a local secret for TMDB access.

TMDB_TOKEN=your_tmdb_bearer_token

3) Run the local development server for MCP.

npm run dev

Additional setup notes

In local development, secrets can be provided via a file named .dev.vars with key-value pairs. An example is shown here.

TMDB_TOKEN=your_tmdb_bearer_token

Available tools

get-movie-detail

Fetches movie details and cast from TMDB by movie title. Returns a structured movie payload including title, poster/backdrop URLs, runtime, genres, rating, and cast.