Skip to content

Latest commit

 

History

536 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mtgacoach — AI-Powered MTGA Coaching & Overlay

Real-time AI coaching for Magic: The Gathering Arena. MTGA Coach tracks your live games and provides real-time strategic advice, draft guidance, voice coaching, and an in-game HUD overlay directly on top of MTGA.


Features

  • Real-Time AI Coaching: Tracks your board, hand, opponent cards, and legal moves to deliver turn-by-turn strategic advice.
  • In-Game HUD Overlay: Transparent, click-through overlay sits directly on top of MTGA showing coach advice, draft ratings, and target highlights.
  • Draft Assistance: Live 17Lands-powered card ratings, composite tier badges, and optimal color-pair recommendations during drafts.
  • Voice Coaching: Spoken advice with neural Text-to-Speech (TTS) and hands-free Push-to-Talk voice questions.
  • Online AI Backend: Hosted coaching uses GLM 5.3 (glm-5.3-flash) through api.mtgacoach.com. Get your Patreon key at mtgacoach.com/subscribe; the same key also works with ArenaOnAir. Retired model names are migrated to GLM 5.3.

Installation

Standard Windows Installer

Download and run mtgacoach-Setup.exe from the Latest Release.


Command-Line Install (uv / pip)

The package (arenamcp) is not published on PyPI — install from source on Windows, macOS, or Linux using uv or pip:

# 1. Install uv (if not already installed):
#    Windows (PowerShell): powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
#    macOS / Linux:       curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Clone and install mtgacoach from source:
git clone https://github.com/josharmour/mtgacoach.git
cd mtgacoach
uv venv
uv pip install -e ".[full]"
# (or with plain pip: python -m pip install -e ".[full]")

# 3. Launch the app:
uv run mtgacoach-desktop

Alternatively, each release attaches a Python wheel (arenamcp-X.Y.Z-py3-none-any.whl) that can be installed directly with uv tool install <wheel-url>.


First Run & Setup

  1. Launch mtgacoach-desktop.
  2. Open the Repair tab — it automatically verifies your MTGA installation, Python runtime, license key, and game logging setup.
  3. Ensure Detailed Logs (Plugin Support) is enabled in MTGA's Account Options menu.

Native macOS Steam installs have an experimental autoplay path that uses screenshots and macOS input, without Wine or BepInEx. See native Mac autoplay setup and limits.


License

MIT License

About

Real-time AI coach for Magic: The Gathering Arena with voice I/O, win plan detection, and MCP server support

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages