varzesh3-mcp
varzesh3-mcp is a read-only MCP server that lets AI agents query Varzesh3's live Iranian sports data, news, and media in Persian without an API key.
Get daily live scores, results, and fixtures across football, futsal, basketball, volleyball, and handball, filtered by day, team, league, sport, or live status.
View match details including score/status, goals, cards, penalties, substitutions, lineups, referee, stadium, summary video, and fan predictions.
Browse leagues and seasons, league tables, group tables, cup brackets, round-by-round fixtures/results, league statistics, and team rankings.
Explore team pages with form, squad, transfers, latest/upcoming matches, player season stats, and head-to-head records.
Check player rankings such as top scorers, assists, clean sheets, cards, minutes, hat-tricks, and average rating, plus player profiles with related news/videos.
Read news headlines, full articles, and videos: latest, most read/commented, or filtered by team, league, player, match, or sport section.
Look up transfer lists by window, club, direction, loan status, and Iranian/European market.
Get the TV broadcast schedule with start times and stream links.
Search Persian names/keywords to turn teams, players, leagues, news, and videos into IDs for other tools.
It is read-only: no login, posting, voting, betting odds, per-match possession/shot stats, or player career statistics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@varzesh3-mcp Show me the Persian Gulf Pro League table"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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-mcporclaude 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-mcpClaude 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 |
| Get the live scores, results and fixtures of one day across leagues, as the Varzesh3 live score page lists them |
| Get one match: score, status, goals, cards, penalties, substitutions, lineups, referee, stadium, summary video and next matches |
| List the football leagues with their ids, or get one league's current season id and past seasons with winners |
| Get the table of a football league (rank, played, won, drawn, lost, goals, points, recent form), group tables or a cup bracket |
| Get a football league's matches round by round: scores of played rounds and dates of coming ones |
| Get the best players of a football league by one statistic, e.g. top scorers or most assists |
| Get a football team's page: name, followers, recent form, squad by position and optionally transfers |
| Get a football team's latest results or its upcoming matches across all competitions |
| Get Varzesh3 news headlines with a short summary: latest, most read, most commented, or about a team, league, player, match or sport |
| Read one news story: title, publish time, full text, tags and the match it is about |
| Get Varzesh3 videos (goals, match summaries, interviews): latest, or about one team, league, match or player |
| Get a football league's season statistics: goals per match, cards per match, goal timing, streak notes and team rankings |
| Get the season statistics of one football team's players: goals, assists, appearances, minutes, cards |
| Get a player's profile (team, position, shirt number, age, country) with his latest news and videos |
| Get the past meetings of two football teams with a won/drawn/lost summary |
| Get the football transfer list of a window, club by club: players signed and players who left |
| Get the live broadcast schedule of sports matches for the next days, with start times and stream links |
| 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 toolsv3_articleNews storyARead-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 headARead-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 seasonsARead-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 resultsARead-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 statisticsARead-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 detailARead-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_newsNewsARead-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 profileARead-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 dayARead-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_searchSearchARead-onlyIdempotent
Search Varzesh3 for teams, people, leagues, news and videos by name; the way to turn a name into an id.
Use it first when the user names a team or player: entities carry the ids. Persian only; English names usually find nothing.
Inputs: query (required), limit.
v3_standingsLeague tableARead-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 pageARead-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 matchesARead-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 teamARead-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 leagueARead-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_transfersTransfersARead-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 scheduleBRead-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_videosVideosARead-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
Scored across 18 tools
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.
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.
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.
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
Related MCP Connectors
Football fixtures, standings, and odds intelligence for AI agents.
NBA, NFL, NHL and combined sports scores as agent tools.
Live SEO intelligence, rank tracking, site audits, and backlink analysis for AI agents.
Structured Japan sports schedules, fixtures, broadcasts, and live updates for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to access comprehensive sports data including football, basketball, American football, and hockey leagues via 11 tools, with no API key required.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query sports data including teams, players, events, and standings from TheSportsDB through natural language or direct tool calls.75 npmMIT
- AlicenseAqualityCmaintenanceEnables 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.1131 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to retrieve soccer match details, live scores, fixtures by date, and win/draw/loss predictions through the Sportmonks Football v3 API.285 npmMIT