Rotten Tomatoes MCP server for AI agents
Let Claude, ChatGPT or your own agent read Rotten Tomatoes: 2 typed functions through one MCP server. No Rotten Tomatoes API key needed.
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Rotten Tomatoes
An MCP server for Rotten Tomatoes alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/rottentomatoesEvery site
One MCP server for Rotten Tomatoes and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
getTitleReads one movie or TV series page: Tomatometer and Popcornmeter with their review and rating counts, plus year, rating, genres and synopsis.Arguments
Name Type Required pathstringYes Returns
RtTitleinterface RtTomatometer { /** % of critic reviews that are positive, 0-100. */ score: number | null; /** Mean critic rating out of 10. */ averageRating: number | null; /** Number of counted critic reviews. */ reviewCount: number | null; likedCount: number | null; notLikedCount: number | null; certifiedFresh: boolean; sentiment: string | null; } interface RtPopcornmeter { /** % of audience ratings that are positive, 0-100. */ score: number | null; /** Mean audience rating out of 5. */ averageRating: number | null; /** Exact audience rating count (liked + not liked) when the page publishes it. */ ratingCount: number | null; /** The page's own banded label, e.g. "250,000+ Ratings". */ bandedRatingCount: string | null; /** Written audience reviews. */ reviewCount: number | null; /** The "Verified Hot" badge. */ verifiedHot: boolean; sentiment: string | null; } interface RtTitle { kind: "movie" | "tv"; path: string; url: string; title: string; year: number | null; /** ISO date the page gives as the title's creation/premiere date. */ releaseDate: string | null; contentRating: string | null; genres: string[]; description: string | null; posterUrl: string | null; /** TV only. */ numberOfSeasons: number | null; /** Null when the title has no critics score block at all. For a TV series it is the series average. */ tomatometer: RtTomatometer | null; /** Null when the page hides or lacks the audience score. For a TV series it is the series average. */ popcornmeter: RtPopcornmeter | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/rottentomatoes/getTitleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.rottentomatoes.getTitle("/m/inception");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.rottentomatoes.getTitle("/m/inception"))curl -X POST https://api.bowmark.ai/v1/sites/rottentomatoes/getTitle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"/m/inception"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.rottentomatoes.getTitle("/m/inception");searchRuns the site's own title search and returns movies and TV series with their Tomatometer, year, top cast and page path.Arguments
Name Type Required querystringFree text, e.g. "inception".Yes type"movie" | "tv" | "all""movie", "tv" or "all" (default).No limitnumber1-20 per kind, default 10.No Returns
RtSearchResponseinterface RtSearchResult { kind: "movie" | "tv"; title: string; /** "/m/inception" or "/tv/breaking_bad", pass to getTitle. */ path: string; url: string; /** Movie: release year. TV: first-air year. */ year: number | null; /** TV only: last year aired, null while running. */ endYear: number | null; /** Tomatometer 0-100, null when the title has too few critic reviews. */ tomatometer: number | null; certifiedFresh: boolean; cast: string[]; } interface RtSearchResponse { query: string; results: RtSearchResult[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/rottentomatoes/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.rottentomatoes.search({ query: "inception", type: "movie", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.rottentomatoes.search({"query": "inception", "type": "movie", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/rottentomatoes/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"inception","type":"movie","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.rottentomatoes.search({ query: "inception", type: "movie", limit: 5 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/rottentomatoes/<function> - OpenAPI
/v1/sites/rottentomatoes/openapi.json