Entertainment Meter MCP Server

A Model Context Protocol server that lets any MCP-compatible AI client (Claude Desktop, VS Code Copilot, Cursor, etc.) fetch buzz score and watch score for movies, series, and anime from entertainmentmeter.com.

It is a thin wrapper around the public REST endpoints (/api/search, /api/titles, /api/titles/{id}) — no database credentials or API keys needed.

Tools exposed

| Tool | Description | | --- | --- | | search_titles | Search tracked titles by name; returns buzz + watch score for each match. | | list_titles | List/sort titles by category, genre, sort (buzz / growth / mentions / title). | | get_buzz_score | Return buzz score (0–100) + trend/growth for one title (by id or query). | | get_watch_score | Return AI watch score (0–100) + consensus label + recommendation. | | get_title_detail | Full detail: scores, sentiment breakdown, trend history, related titles. |

Install & run locally

cd mcp-server
npm install
npm run build
npm start

Or run without building:

npm run dev

By default it points at https://entertainmentmeter.com. Override with:

EM_API_BASE_URL=http://localhost:3000 npm run dev

Debug with MCP Inspector

npm run inspect

Opens a web UI where you can invoke each tool and inspect the JSON-RPC payloads.

Configure in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "entertainment-meter": {
      "command": "npx",
      "args": ["-y", "entertainment-meter-mcp"]
    }
  }
}

Or from a local checkout:

{
  "mcpServers": {
    "entertainment-meter": {
      "command": "node",
      "args": ["/absolute/path/to/movie-buzz-web/mcp-server/dist/index.js"]
    }
  }
}

Configure in VS Code

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "entertainment-meter": {
      "command": "node",
      "args": ["/absolute/path/to/movie-buzz-web/mcp-server/dist/index.js"]
    }
  }
}

Publish to npm (optional)

So anyone can npx entertainment-meter-mcp:

npm run build
npm login
npm publish --access public

Example prompts once connected

• "What's the buzz score for Dhurandhar right now?"
• "Give me the top 10 series by buzz score."
• "Compare watch scores for The Boys and Invincible."