Skip to main content
Glama
varzesh3-mcp

varzesh3-mcp

by sepehr071

varzesh3-mcp: Varzesh3 (ورزش سه) Iranian sports MCP server for AI agents

varzesh3-mcp is an unofficial, read-only MCP server that gives AI agents the data of Varzesh3 (varzesh3.com), the biggest Iranian sports site. Its 18 tools read live scores, match details with goals, cards and lineups, league tables, fixtures and results, top scorers, player profiles and team statistics, head-to-head, transfers, the TV schedule, news stories and videos, in football, with futsal, volleyball, basketball and handball leagues and news for other sports. 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 · What it can do · Tools · FAQ · فارسی


For AI agents

  • What: unofficial MCP server (model context protocol) for varzesh3.com: scores of a day across leagues, one match (events, lineups, referee, stadium, summary video), league tables (also groups and cup brackets), round-by-round fixtures and results, top scorers and other player rankings, team pages (form, squad, transfers), a team's results and next matches, news (latest, most read, by team or league), news story text, videos and search.

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

  • Auth: none, no API key or account. Optional VARZESH3_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.

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

  • Tools: 18, all prefixed v3_. Typical sequences: v3_search (a name) -> v3_team / v3_team_matches / v3_news; v3_scores -> v3_match; v3_league -> v3_standings / v3_top_players; v3_head_to_head; v3_team_players -> v3_player; v3_transfers.

  • Use when: the user asks for today's or yesterday's scores, a team's last results or next match, the Iranian Pro League (or any big league) table, top scorers, who plays for a team, a transfer list, or the latest sports news in Persian.

  • Do not use when: the user wants per-match possession or shot statistics (Varzesh3 has none; team season averages are in v3_league_stats), betting odds, or player career statistics.

  • Output: compact JSON. Dates are Persian (Jalali) as the site shows them, times are Tehran time, scores are "home-away". Names and news are Persian.

  • Machine-readable: server.json.

Related MCP server: mcp-thesportsdb

What it can do

  • Scores of a day (yesterday, today, tomorrow, plus two days either side) for all leagues, football, futsal and NBA, filtered by league, team or live only

  • Match detail: goals with scorers and assists, cards, substitutions, lineups by formation line, bench, coaches, referee, stadium and the summary video

  • League tables with form, group tables (World Cup, Asian cups) and knockout brackets (Hazfi Cup), for the current or a past season

  • Fixtures and results round by round, and a team's last results or upcoming matches

  • Player rankings: top scorers, assists, clean sheets, yellow and red cards, minutes, hat tricks, average rating

  • Team page: recent form, squad by position with numbers and ages, transfers in and out

  • News, stories and videos: latest, most read, by team or league, the full story text, goal and summary videos

  • Search a Persian name to get the team id the other tools need

  • Read-only by design: no login, no posting

Example prompts:

  • "What is the result of Perspolis today?"

  • "Show the Persian Gulf Pro League table."

  • "Top 5 scorers of the Premier League."

  • "Who played for Esteghlal in the last match, and who scored?"

  • جدول لیگ برتر ایران چطوره؟

  • آخرین اخبار استقلال را بگو.

Quick start

You need uv. No API key or account.

claude mcp add varzesh3 -- uvx varzesh3-mcp

Claude Desktop, Cursor, Windsurf and Gemini CLI use the same block in their MCP config:

{
  "mcpServers": {
    "varzesh3": { "command": "uvx", "args": ["varzesh3-mcp"] }
  }
}

VS Code (.vscode/mcp.json): {"servers": {"varzesh3": {"type": "stdio", "command": "uvx", "args": ["varzesh3-mcp"]}}}. Codex CLI: codex mcp add varzesh3 -- uvx varzesh3-mcp. Anything else: pip install varzesh3-mcp and run varzesh3-mcp.

Tools

Team ids come from v3_search (or any table), league ids from v3_league, match ids from v3_scores, v3_league_matches and v3_team_matches.

Tool

What it does

v3_scores

Get the live scores, results and fixtures of one day across leagues, as the Varzesh3 live score page lists them

v3_match

Get one match: score, status, goals, cards, penalties, substitutions, lineups, referee, stadium, summary video and next matches

v3_league

List the football leagues with their ids, or get one league's current season id and past seasons with winners

v3_standings

Get the table of a football league (rank, played, won, drawn, lost, goals, points, recent form), group tables or a cup bracket

v3_league_matches

Get a football league's matches round by round: scores of played rounds and dates of coming ones

v3_top_players

Get the best players of a football league by one statistic, e.g. top scorers or most assists

v3_team

Get a football team's page: name, followers, recent form, squad by position and optionally transfers

v3_team_matches

Get a football team's latest results or its upcoming matches across all competitions

v3_news

Get Varzesh3 news headlines with a short summary: latest, most read, most commented, or about a team, league, player, match or sport

v3_article

Read one news story: title, publish time, full text, tags and the match it is about

v3_videos

Get Varzesh3 videos (goals, match summaries, interviews): latest, or about one team, league, match or player

v3_league_stats

Get a football league's season statistics: goals per match, cards per match, goal timing, streak notes and team rankings

v3_team_players

Get the season statistics of one football team's players: goals, assists, appearances, minutes, cards

v3_player

Get a player's profile (team, position, shirt number, age, country) with his latest news and videos

v3_head_to_head

Get the past meetings of two football teams with a won/drawn/lost summary

v3_transfers

Get the football transfer list of a window, club by club: players signed and players who left

v3_tv_schedule

Get the live broadcast schedule of sports matches for the next days, with start times and stream links

v3_search

Search Varzesh3 for teams, people, leagues, news and videos by name; the way to turn a name into an id

All 18 tools are annotated readOnlyHint: true.

FAQ

Does it need an account or key? No.

Why do I get HTTP 5xx? Varzesh3's CDN sometimes refuses a network; set VARZESH3_MCP_PROXY=http://host:port to route through another exit.

Are there match statistics (possession, shots)? No, the site does not publish them.

Is it official? No. It is unaffiliated with Varzesh3, reads only what the public site shows, and is meant for personal and research use. Respect the site's terms.

فارسی

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

نصب: claude mcp add varzesh3 -- uvx varzesh3-mcp


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

18 tools
v3_articleNews storyA
Read-onlyIdempotent

Read one news story: title, publish time, full text (up to 6000 characters), tags and the match it is about.

Inputs: news_id (required).

v3_head_to_headHead to headA
Read-onlyIdempotent

Get the past meetings of two football teams with a won/drawn/lost summary for team_id.

No upstream head-to-head page: this scans the last depth*24 matches of team_id (all competitions) for the opponent; raise depth to look further back. Each meeting has an id for v3_match.

Inputs: team_id (required), opponent_id (required), depth, limit.

v3_leagueLeagues and seasonsA
Read-onlyIdempotent

List the football leagues with their ids, or get one league's current season id and past seasons with winners.

Call it without league_id to find an id (Iranian Pro League 6, Premier League 3, La Liga 2, Serie A 4). Any league_id from v3_scores works too (55 Portuguese, 35 Turkish). Past seasons are football only. Other sports: sport="futsal" (league 27), "volleyball" (33), "basketball" (32; NBA 209) or "handball" (4).

Inputs: sport, league_id.

v3_league_matchesLeague fixtures and resultsA
Read-onlyIdempotent

Get a league's matches round by round: scores of played rounds and dates of coming ones.

Start with which="current", then page with "upcoming" or "results" and skip=9 (about a round). Each match has an id for v3_match.

Inputs: league_id (required), skip, sport, which, +1 more.

v3_league_statsLeague statisticsA
Read-onlyIdempotent

Get a football league's season statistics: goals per match, cards per match, goal timing, streak notes and team rankings.

Without ranking you get the top 3 teams in each category. For players use v3_top_players.

Inputs: league_id (required), ranking, season_id.

v3_matchMatch detailA
Read-onlyIdempotent

Get one match: score, status, goals, cards, penalties, substitutions, lineups, referee, stadium, summary video.

Use it after v3_scores or a list tool gave a match id. Lineups appear only close to kick-off. No per-match possession or shot statistics. Basketball gives quarter points, volleyball set scores, plus both teams' last matches.

Inputs: match_id (required), sport, prediction.

v3_newsNewsA
Read-onlyIdempotent

Get Varzesh3 news headlines with a short summary: latest, most read, most commented, or about a team, league, player, match or sport.

Call v3_article with a news id for the whole story. scope="section" returns ~60 newest news and videos mixed (type tells which).

Inputs: id, skip, take, scope, +2 more.

v3_playerPlayer profileA
Read-onlyIdempotent

Get a player's profile (team, position, shirt number, age, country) with his latest news and videos.

No career or season statistics here: use v3_team_players or v3_top_players.

Inputs: player_id (required), sport.

v3_scoresScores of a dayA
Read-onlyIdempotent

Get the live scores, results and fixtures of one day across leagues.

Every match has an id for v3_match. Filter by league_id or team to keep it short. Scores are "home-away"; status: scheduled, live, finished, postponed, cancelled or incomplete (played, no final result yet). Basketball scores are points; volleyball rows carry sets, basketball quarters. day=0 switches to the new Jalali day some hours after midnight Tehran time.

Inputs: day, team, sport, league_id, +2 more.

v3_standingsLeague tableA
Read-onlyIdempotent

Get a league table (rank, played, won, drawn, lost, goals, points, form), group tables or a cup bracket.

Groups (World Cup) return one table per group; cups need stage="knockout". form is the last five results W/D/L, oldest first. Zones are in zones. Volleyball adds sets and points for/against.

Inputs: league_id (required), sport, stage, season_id.

v3_teamTeam pageA
Read-onlyIdempotent

Get a football team's page: name, followers, recent form, squad by position and optionally transfers.

form is the last three results W/D/L, newest first, for all, home and away. For matches use v3_team_matches, for news v3_news(scope="team").

Inputs: team_id (required), sport, squad, transfers.

v3_team_matchesTeam matchesA
Read-onlyIdempotent

Get a football team's latest results or upcoming matches across all competitions.

Each match has an id for v3_match.

Inputs: team_id (required), limit, sport, which.

v3_team_playersPlayers of a teamA
Read-onlyIdempotent

Get the season statistics of one football team's players: goals, assists, appearances, minutes, cards.

Defaults to the current season of the team's main league; competitions lists others to pass as league_id. Players with zero in the chosen stat may be missing.

Inputs: team_id (required), stat, league_id, season_id.

v3_top_playersTop players of a leagueA
Read-onlyIdempotent

Get the best players of a football (or futsal) league by one statistic, e.g. top scorers or most assists.

Each player has an id for v3_player, team and season counters (a missing counter is zero). For one team use v3_team_players.

Inputs: league_id (required), stat, limit, sport, +1 more.

v3_transfersTransfersA
Read-onlyIdempotent

Get the football transfer list of a window, club by club: players signed and players who left.

Filter by team_id to keep it short. windows lists earlier windows for window_id.

Inputs: limit, loans, market, team_id, +2 more.

v3_tv_scheduleTV scheduleB
Read-onlyIdempotent

Get the live broadcast schedule (جدول پخش زنده) of sports matches for the next days, with start times and stream links.

match_id (when linked to a football match) goes to v3_match.

Inputs: query, max_items.

v3_videosVideosA
Read-onlyIdempotent

Get Varzesh3 videos (goals, match summaries, interviews): latest, or about one team, league, match or player.

Each video has a page url on video.varzesh3.com.

Inputs: id, skip, take, scope, +1 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 18 tools

    Disambiguation4/5

    Tools map cleanly to distinct resources (match, team, player, league, news, video, transfers), and descriptions explicitly cross-reference alternatives (e.g. 'For players use v3_top_players', 'Use it after v3_scores'). The main soft overlaps are v3_scores vs v3_league_matches vs v3_team_matches (all return match lists) and v3_league_stats vs v3_standings, but the scoping hints (day vs round vs team; stats vs table) keep them separable.

    Naming Consistency5/5

    Every tool uses the same v3_ prefix with snake_case resource nouns (v3_team_matches, v3_team_players, v3_league_stats, v3_head_to_head). Variations like team/team_matches/team_players follow a predictable noun-modifier pattern rather than ad-hoc naming.

    Tool Count4/5

    18 tools is on the higher side but each corresponds to a real, non-redundant entity or view (scores, match, league, standings, team, team matches, team players, top players, player, news, article, videos, search, transfers, TV schedule, H2H, league stats, league matches). The surface is broad rather than padded, so the count is justified, if slightly heavy.

    Completeness4/5

    Coverage spans discovery (search), fixtures/results (scores, league_matches, team_matches), detail (match, standings, league stats), squads/players (team, team_players, top_players, player), media (news, article, videos), plus transfers, TV schedule and H2H — a full lifecycle for the domain. Minor gaps: no cross-league player career/stat lookup or match-level advanced stats (the latter explicitly noted as unavailable upstream), workable via v3_team_players and v3_top_players.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to access comprehensive sports data including football, basketball, American football, and hockey leagues via 11 tools, with no API key required.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to query sports data including teams, players, events, and standings from TheSportsDB through natural language or direct tool calls.
      75 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to query live football data, including fixtures, live scores, standings, statistics, betting odds, and full odds movement history for corner and card lines.
      11
      31 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to retrieve soccer match details, live scores, fixtures by date, and win/draw/loss predictions through the Sportmonks Football v3 API.
      285 npm
      MIT