mcp-metacritic

Metacritic gathers what critics and audiences said about films, television series and video games. Each entry carries the year, the age rating, the genres, and two scores of its own: the Metascore, a weighted average of the professional reviews, and the user score, out of ten, from the people who signed up to rate it. Under each entry sit the reviews themselves, with the publication that ran them and the quoted line.

This server connects a chat client to that catalogue. You can search for a title, read its entry with its scores and its details, browse a catalogue by score, recency or popularity, and read the reviews of one title, filtered by critic or audience and by how favourable they were. It needs no API key and no account.

Version française

Install

One-click install

Claude Code

claude mcp add metacritic -- npx -y mcp-metacritic

Claude Desktop, Cursor, and any client using the standard config format

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

Node 24 or later is required, and no environment variable has to be set.

With Docker

{
  "mcpServers": {
    "metacritic": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-metacritic:2.0.1"]
    }
  }
}

-i keeps stdin open, which is where the protocol travels, and -t is left out because a TTY rewrites the stream. The container needs outbound HTTPS to backend.metacritic.com, and nothing else: no volume, no port, no credential.

Bundle, without npm

Download mcp-metacritic-2.0.1.mcpb from the latest release and open it. A client that supports MCP bundles installs it on its own, with no npm and no configuration file to edit. The bundle carries its dependencies, so nothing is fetched at install time.

What you can ask

• "What did critics make of The Matrix?"
• "Read me a few negative reviews of that game."
• "What are the best-reviewed horror films?"
• "How does the user score compare to the Metascore?"
• "What came out recently that reviewed well?"

The ordinary path runs from a search to an entry: a row carries a slug and a kind, and get_title and get_reviews take both together.

Tools

A title is addressed by its slug together with its kind, since the same slug can name a film and a game.

search_titles

Finds films, series and games by title.

In return: rows carrying slug and kind, which get_title and get_reviews take together; title; year; release_date; rating, the age rating as published; metascore; user_score, which the search route publishes for no row and which is null on every one of them; and source_url. A score the site has not computed is null, never 0: on a scale that starts at zero the two would be indistinguishable, and a title with too few reviews carries none.

get_title

Reads one entry. The heavier parts are asked for rather than served by default, and each one beyond the default costs a request.

In return: the entry a search row carries, plus description, tagline, genres, duration_minutes and imdb_id, each null where the page states nothing. total_chars, returned_chars and offset describe the slice of the description served.

get_reviews

Reads the reviews of one entry.

In return: reviews, each with its quote as published, its score, the max that score is out of, which is 100 for a critic and 10 for a user, and the publication that ran it. Name the publication when quoting a review. total_available counts every review Metacritic holds from that source for the entry, whatever sentiment was asked for, since the sentiment sorts the sample this server received rather than the request that fetched it. next_offset continues.

browse_titles

Lists a catalogue.

In return: the rows search_titles returns, with total_available, offset, next_offset and the kind, sort and genre the listing was read under.

Two scores, two things measured

The Metascore is a weighted average of professional reviews, out of 100. The user score is the average of what registered members gave, out of 10. They measure different populations on different scales, and a title can carry one and not the other. Read each with the max its reviews state, and report a missing score as missing.

Configuration

Every variable is optional. Set them in the env block of your client config.

Scores move as reviews come in, especially around a release, so they are held for an hour where a catalogue entry is held for a day. A value outside its range falls back to the default, and the reason is written to stderr.

Errors

Every failure carries one of six codes, a message, and where it helps a hint naming the next move.

As a library

The layer reading the site is published on its own, with its pacing, its cache and its errors, and with no protocol attached.

import { McClient } from "mcp-metacritic/client";

const client = new McClient();
const { data, cached } = await client.getDetail("movie", "the-matrix");
console.log(data.title, data.metascore, cached);

Each read answers { data, cached }, and throws an error carrying one of the six codes. The floor between two requests holds here as well.

Pacing and attribution

Requests go out one at a time with at least a second between them, and the floor of half a second holds however the server is configured. The User-Agent always ends with the project identity and an address where a person can be reached.

Every result carries the address of the Metacritic page, and every quoted review carries the publication that ran it. The reviews belong to their authors and to the publications that ran them.

This MCP server is an unofficial project, with no affiliation to Metacritic.

Privacy

This server collects nothing about you and sends nothing to its author. It runs on your machine, contacts backend.metacritic.com and nothing else, holds its answers in memory while it runs, and writes nothing to disk. PRIVACY.md states what a request carries and which settings change any of it.

Development

npm install
npm run build:fixtures
npm test
npm run check

Tests run against generated fixtures and make no network request. The live suite, npm run test:live, makes one request per route and runs nightly against the site itself.

Contributing

Bugs, questions and ideas belong in the issue tracker. Pull requests are welcome; opening an issue first helps agree on the shape of the change. See CONTRIBUTING.md.

License

MIT, see LICENSE. The scores and the reviews belong to Metacritic and to the publications it quotes.

mcp-metacritic (français)

English version

Metacritic rassemble ce que la critique et le public ont dit des films, des séries et des jeux vidéo. Chaque fiche porte l'année, la classification par âge, les genres, et deux notes qui lui sont propres : le Metascore, moyenne pondérée des critiques professionnelles, et la note des utilisateurs, sur dix, donnée par les inscrits. Sous chaque fiche se trouvent les critiques elles-mêmes, avec la publication qui les a signées et la phrase citée.

Ce serveur relie un client de conversation à ce catalogue. On peut y chercher un titre, lire sa fiche avec ses notes et ses détails, parcourir un catalogue par note, par fraîcheur ou par popularité, et lire les critiques d'un titre, filtrées par source et par tonalité. Aucune clé d'API, aucun compte.

Installation

Installation en un clic

Claude Code

claude mcp add metacritic -- npx -y mcp-metacritic

Claude Desktop, Cursor, et tout client au format de configuration standard

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

Node 24 ou plus récent est nécessaire, et aucune variable d'environnement n'est à renseigner.

Avec Docker

{
  "mcpServers": {
    "metacritic": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-metacritic:2.0.1"]
    }
  }
}

-i garde l'entrée standard ouverte, qui est le canal du protocole, et -t est omis parce qu'un TTY réécrit le flux. Le conteneur a besoin d'un accès HTTPS sortant vers backend.metacritic.com, et de rien d'autre : aucun volume, aucun port, aucun identifiant.

Bundle, sans npm

Téléchargez mcp-metacritic-2.0.1.mcpb depuis la dernière publication et ouvrez-le. Un client qui gère les bundles MCP l'installe seul, sans npm et sans fichier de configuration à modifier. Le bundle emporte ses dépendances, donc rien n'est téléchargé à l'installation.

Ce qu'on peut demander

• « Qu'a pensé la critique de Matrix ? »
• « Lis-moi quelques critiques négatives de ce jeu. »
• « Quels sont les films d'horreur les mieux notés ? »
• « Comment la note du public se compare-t-elle au Metascore ? »
• « Qu'est-il sorti récemment qui a été bien reçu ? »

Le chemin ordinaire va d'une recherche à une fiche : une ligne porte un slug et un kind, et get_title comme get_reviews reprennent les deux ensemble.

Les outils

Un titre s'adresse par son slug accompagné de son kind, un même slug pouvant nommer un film et un jeu.

search_titles

Trouve des films, des séries et des jeux par leur titre.

En retour : des lignes portant slug et kind, que get_title et get_reviews reprennent ensemble ; title ; year ; release_date ; rating, la classification par âge telle que publiée ; metascore ; user_score, que la route de recherche ne publie pour aucune ligne et qui y vaut null partout ; et source_url. Une note que le site n'a pas calculée vaut null, jamais 0 : sur une échelle qui commence à zéro les deux seraient indiscernables, et un titre avec trop peu de critiques n'en porte aucune.

get_title

Lit une fiche. Les parties lourdes se demandent au lieu d'être servies par défaut, et chacune au-delà du défaut coûte une requête.

En retour : la fiche que porte une ligne de recherche, plus description, tagline, genres, duration_minutes et imdb_id, chacun null là où la page n'indique rien. total_chars, returned_chars et offset décrivent la tranche de description servie.

get_reviews

Lit les critiques d'une fiche.

En retour : reviews, chacune avec sa quote telle que publiée, son score, le max sur lequel cette note est donnée, qui vaut 100 pour un critique et 10 pour un utilisateur, et la publication qui l'a signée. Nommez la publication quand vous citez une critique. total_available compte toutes les critiques que Metacritic tient de cette source pour cette fiche, quelle que soit la tonalité demandée, puisque la tonalité trie l'échantillon reçu et non la requête qui l'a cherché. next_offset poursuit.

browse_titles

Liste un catalogue.

En retour : les lignes que rend search_titles, avec total_available, offset, next_offset et les kind, sort et genre sous lesquels la liste a été lue.

Deux notes, deux choses mesurées

Le Metascore est une moyenne pondérée des critiques professionnelles, sur 100. La note des utilisateurs est la moyenne de ce qu'ont donné les membres inscrits, sur 10. Elles mesurent des populations différentes sur des échelles différentes, et un titre peut porter l'une sans l'autre. Lisez chacune avec le max que ses critiques indiquent, et rapportez une note absente comme absente.

Configuration

Chaque variable est facultative. Elles se posent dans le bloc env de la configuration du client.

Les notes bougent au fil des critiques, surtout autour d'une sortie, donc elles sont gardées une heure là où une fiche l'est un jour. Une valeur hors de sa plage retombe sur le défaut, et la raison est écrite sur la sortie d'erreur.

Erreurs

Chaque échec porte un des six codes, un message, et quand cela aide une indication du geste suivant.

Comme bibliothèque

La couche qui lit le site est publiée seule, avec son rythme, son cache et ses erreurs, sans protocole attaché.

import { McClient } from "mcp-metacritic/client";

const client = new McClient();
const { data, cached } = await client.getDetail("movie", "the-matrix");
console.log(data.title, data.metascore, cached);

Chaque lecture répond { data, cached }, et lève une erreur portant un des six codes. Le plancher entre deux requêtes tient également ici.

Rythme et attribution

Les requêtes partent une à une avec au moins une seconde entre elles, et le plancher d'une demi-seconde tient quelle que soit la configuration. Le User-Agent se termine toujours par l'identité du projet et une adresse où joindre une personne.

Chaque résultat porte l'adresse de la page Metacritic, et chaque critique citée porte la publication qui l'a signée. Les critiques appartiennent à leurs auteurs et aux publications qui les ont publiées.

Ce MCP est un projet non officiel, sans affiliation à Metacritic.

Confidentialité

Ce serveur ne collecte rien sur vous et n'envoie rien à son auteur. Il tourne sur votre machine, ne joint que backend.metacritic.com, garde ses réponses en mémoire le temps qu'il tourne, et n'écrit rien sur le disque. PRIVACY.md dit ce qu'une requête emporte et quels réglages changent cela.

Développement

npm install
npm run build:fixtures
npm test
npm run check

Les tests s'exécutent sur des fixtures engendrées et n'émettent aucune requête. La suite en direct, npm run test:live, émet une requête par route et tourne chaque nuit contre le site lui-même.

Contribuer

Les anomalies, les questions et les idées ont leur place dans le suivi d'incidents. Les propositions de modification sont bienvenues ; ouvrir un ticket d'abord aide à s'accorder sur la forme du changement. Voir CONTRIBUTING.md.

Licence

MIT, voir LICENSE. Les notes et les critiques appartiennent à Metacritic et aux publications qu'il cite.