Skip to main content
Glama

gamefa-mcp: Gamefa (گیمفا) game and film news, reviews and release calendar MCP server for AI agents

gamefa-mcp is an unofficial, read-only MCP server that gives AI agents Gamefa (گیمفا, gamefa.com), the large Persian site for video games, film and tech. Its 13 tools search and read articles, list the editors' scored reviews, browse game and film profiles with Gamefa, user and IMDb scores, show the upcoming release calendar and rank the most read articles. No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

PyPI License: PolyForm Noncommercial

For AI agents · Quick start · Tools · فارسی


For AI agents

  • What: unofficial MCP server (model context protocol) for gamefa.com: news and review search, full article text, review scores with pros and cons, game profiles (Gamefa score, user score, Metacritic, platforms, genres, publisher, release date), film and series profiles (IMDb, cast, director), upcoming game releases, most read articles.

  • Install: uvx gamefa-mcp or claude mcp add gamefa -- uvx gamefa-mcp. Transport: stdio. Needs uv (Python 3.10+).

  • Auth: none. Optional GAMEFA_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.

  • Access: read-only. It cannot log in, comment or rate, so no confirmation is needed before calling any tool.

  • Tools: 13, all prefixed gf_. Typical sequences: gf_games(query) -> gf_game(slug) -> gf_article(review id); gf_upcoming_games; gf_search_articles -> gf_article.

  • Use when: the user asks what Gamefa says about a game, its review score, the latest game or film news, what releases next, top rated games of a platform or genre, or what is trending.

  • Do not use when: the user needs scores from other sites (Metacritic, OpenCritic) beyond what Gamefa lists, or prices and stores.

  • Output: compact JSON. Article text is Persian; game and film titles are English. Scores are out of 10; release dates come as Jalali and ISO.

Related MCP server: mcp-metacritic

Quick start

claude mcp add gamefa -- uvx gamefa-mcp

Or in any MCP client config: {"command": "uvx", "args": ["gamefa-mcp"]}.

Tools

Tool

What it does

gf_search_articles

Search news, reviews and features by keyword, optionally in one section

gf_latest_articles

Newest articles, optionally for news, reviews, trailers, pc, playstation, cinema...

gf_article

Full article text by id or slug; reviews include score, label, verdict, pros, cons

gf_reviews

Latest game reviews with the editors' score out of 10

gf_popular

Most viewed articles of the week, month, season or year

gf_games

Game profiles with Gamefa and user scores; sort, search, filter by platform, genre, developer, publisher, release year

gf_upcoming_games

Release calendar: unreleased games, soonest first; by month, platform or genre

gf_game

One game profile: scores, Metacritic, release, platforms, genres, review link

gf_films

Film and series profiles with IMDb and user scores; filter by movie/series, genre, person, studio, country, language, year

gf_film

One film or series: cast, director, countries, runtime, scores

gf_terms

Look up the slug of a platform, genre, developer, publisher, film person or studio, or an article tag

gf_comments

Reader comments (with likes) under an article or a game/film profile

gf_related

Articles Gamefa links to a game/film, or similar games/films

FAQ

Does it need an account? No. Is it official? No, it reads the public pages and REST API of gamefa.com. Which network? Both Iranian and foreign connections reach the site; set GAMEFA_MCP_PROXY if yours is blocked.

فارسی

gamefa-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای سایت گیمفا (gamefa.com) است: جست‌وجوی اخبار و مقالات، متن کامل نقدها همراه با امتیاز، مشخصات و امتیاز بازی‌ها و فیلم‌ها، بازی‌های در راه و پربازدیدترین مطالب. نیازی به کلید API یا حساب کاربری نیست.


Made by Sepehr Radmard (سپهر رادمرد): github.com/sepehr071 · linkedin.com/in/sepehr-radmard.

مجوز استفاده (License)

استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیت‌هاب با سپهر رادمرد تماس بگیرید. متن کامل: PolyForm Noncommercial 1.0.0. نسخه‌های پیش از 0.2.1 با مجوز MIT منتشر شده‌اند و همان مجوز را دارند.

Free for personal and non-commercial use under the PolyForm Noncommercial License 1.0.0. Using it in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on LinkedIn or GitHub. Versions before 0.2.1 were released under MIT and stay under it.

Available Tools

13 tools
gf_articleRead an articleA
Read-onlyIdempotent

Read one Gamefa article as plain text, with the editors' score box when it is a review.

Reviews carry review (score out of 10, label, verdict, pros, cons). tags slugs fit the tag filter.

Inputs: article (required), max_chars.

gf_commentsComments on an article or profileA
Read-onlyIdempotent

Read the public reader comments under a Gamefa article or a game/film profile, with likes and dislikes.

On a profile, comments hold user verdicts. Replies carry reply_to (parent comment id).

Inputs: post_id (required), page, sort, limit.

gf_filmFilm profileA
Read-onlyIdempotent

Get one film or series profile: IMDb and user score, genres, cast, director, writers, countries, runtime, release date.

Includes post_id for gf_comments.

Inputs: slug (required).

gf_filmsFilm and series profilesA
Read-onlyIdempotent

Browse or search Gamefa's film and TV series profiles with IMDb score, user score, genres, director and release date.

At most one of type, genre, person, company, country, language, year (slugs: gf_terms); query works alone. Small sets are read whole (complete: true), big ones only through the first depth pages (partial: true). Profile: gf_film.

Inputs: page, sort, type, year, +8 more.

gf_gameGame profileA
Read-onlyIdempotent

Get one game's Gamefa profile: editors' score, user score and votes, Metacritic, release date, description.

Also platforms, genres, developers, publishers (with filter slugs), post_id and review_url (read with gf_article).

Inputs: slug (required).

gf_gamesGame profilesA
Read-onlyIdempotent

Browse or search Gamefa's game profiles with the editors' score, user score, genres, platforms and release date.

At most one of platform, genre, developer, publisher (slugs: gf_terms); query works alone. Filters up to 288 games are read whole (complete: true); bigger ones with a sort or year scan the first depth pages, so raise depth for deeper results. Profile: gf_game.

Inputs: page, sort, year, depth, +6 more.

gf_latest_articlesLatest articlesA
Read-onlyIdempotent

List the newest Gamefa articles, optionally for one section such as news, reviews, trailers or pc.

Returns id, title, date, url and summary. Yearly top lists: category best-lists or scores with year.

Inputs: tag, page, year, limit, +1 more.

gf_reviewsGame reviews with scoresA
Read-onlyIdempotent

List Gamefa's game reviews newest first, each with the editors' score out of 10, label, pros and cons.

min_score filters after paging, so a page may return fewer than limit; old reviews may lack a score. Full text: gf_article.

Inputs: page, year, limit, query, +1 more.

gf_search_articlesSearch articlesA
Read-onlyIdempotent

Search Gamefa's news, reviews and features by keyword, newest matches first.

Returns id, title, date, url and summary per article; read one with gf_article. For a game's score use gf_game.

Inputs: query (required), tag, page, year, +2 more.

gf_termsFind filter slugsA
Read-onlyIdempotent

Find the slug of a platform, genre, developer, publisher, film person or studio, or an article topic tag.

Each hit has slug, name and item count; without query the biggest come first.

Inputs: kind (required), limit, query.

gf_upcoming_gamesUpcoming game releasesA
Read-onlyIdempotent

List games that have not been released yet, soonest first (Gamefa's release calendar), with ISO release dates.

Far-off dates may be placeholders; months far ahead scan up to depth pages.

Inputs: page, depth, genre, limit, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 13 tools

    Disambiguation4/5

    Tools are mostly cleanly separated by resource and action: gf_games vs gf_game and gf_films vs gf_film use singular/plural to distinguish list from detail, and gf_search_articles vs gf_reviews vs gf_latest_articles have distinct intents. There is some residual overlap among the article-listing tools (search, latest, popular, reviews), but the descriptions clarify when to use each.

    Naming Consistency5/5

    Every tool uses the gf_ prefix and snake_case, with plural resource names for list operations and singular names for single-item reads (gf_games/gf_game, gf_films/gf_film). Modifier-led variants (gf_latest_articles, gf_upcoming_games, gf_popular, gf_related) follow the same predictable pattern.

    Tool Count5/5

    Thirteen tools is well within the ideal range and each covers a distinct content type or operation: articles, reviews, games, films, terms, comments and related content. No tool appears redundant or filler.

    Completeness4/5

    The surface covers search, browsing, detail views, comments and related content across both games and films, which is strong lifecycle coverage for a content site. Minor gaps remain, such as no dedicated tag/category browsing tool or explicit trailer listing beyond the section filter on gf_latest_articles, but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Search, trending, topics, and local news all in one MCP server. Article previews, deduplication, source filtering, and 40+ languages built in.
      39 npm
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Metacritic that enables searching films, shows, and games, retrieving Metascores and audience scores, and accessing critic reviews with publication details and links, all without requiring an API key.
      4
      92 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A read-only MCP server that lets AI agents search MasterKala's catalog of gadgets and accessories, compare prices and specs, read reviews, check stock and delivery slots, and surface today's discounts. It runs locally over stdio with no login or API key, returning compact structured JSON.
      14
      304 PyPI
      PolyForm Noncommercial 1.0.0
    • A
      license
      A
      quality
      B
      maintenance
      An unofficial, read-only MCP server that lets AI agents pull current Persian-language headlines and article text from six outlets — Mehr, Khabaronline, Hamshahri, Tabnak, Zoomit and Digiato. It exposes latest items per source and category, a time-merged overview, cross-source keyword search, and full story bodies.
      6
      305 PyPI
      1
      PolyForm Noncommercial 1.0.0