mcp-metacritic
[npm]
[CI]
[license]
[MCP Registry]
[Glama]
[M8ven]
[LobeHub]
[Install in Cursor]
[Install in VS Code]
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
[Install in Cursor]
[Install in VS Code]
Claude Code
Claude Desktop, Cursor, and any client using the standard config format
Node 24 or later is required, and no environment variable has to be set.
With Docker
-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.1.0.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.
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
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
[Install in Cursor]
[Install in VS Code]
Claude Code
Claude Desktop, Cursor, et tout client au format de configuration standard
Node 24 ou plus récent est nécessaire, et aucune variable d'environnement n'est à
renseigner.
Avec Docker
-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.1.0.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é.
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
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.
