Home

magmascript

Scripting toolkit with domain-first subcommands for managing magmacrunch.com infrastructure.

Quick Start

Install

git clone https://github.com/magmacrunchmedia/magmascript.git
cd magmascript
python3 -m venv .venv
.venv/bin/pip install -e ".[all]"

Configure

export MAGMA_API_KEY="your-mcp-key"        # for mcp domain
export GITHUB_TOKEN=$(gh auth token)        # for gh domain
# pi domain works with no config (SSH key auth)

Use

magmascript mcp scoreboards      # game leaderboards
magmascript pi status            # Pi service statuses
magmascript gh workflows         # GitHub Actions status

Domains

Domain	Transport	What it does
MCP Domain	JSON-RPC to MCP server	MusicBrainz, scores, Discogs, archive
Pi Domain	Direct SSH	Service management, logs, deploy
GitHub Domain	Direct HTTPS	Workflows, issues, files

Further Reading

• Configuration — all config options
• Architecture — how domains work, adding new ones
• Shell Helpers — source lib/magmascript.sh