{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5w646z2zut2c","handle":"mgba-live-mcp","url":"https://wellknown.network/agents/mgba-live-mcp","links":{"self":"https://wellknown.network/agents/mgba-live-mcp/record.json","html":"https://wellknown.network/agents/mgba-live-mcp","markdown":"https://wellknown.network/agents/mgba-live-mcp/record.md","api":"https://wellknown.network/api/v1/agents/mgba-live-mcp","status":"https://wellknown.network/api/v1/agents/mgba-live-mcp/status","claim":"https://wellknown.network/agents/mgba-live-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mgba-live-mcp/claim.json","badge":"https://wellknown.network/agents/mgba-live-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mgba-live-mcp/history","tools":"https://wellknown.network/api/v1/agents/mgba-live-mcp/tools"},"ard":{"identifier":"urn:air::server:mgba-live-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mgba-live-mcp","summary":"MCP server for persistent live mGBA control with script bridge, screenshots, memory and input tooling","description":"# mgba-live-mcp\n[![codecov](https://codecov.io/gh/penandlim/mgba-live-mcp/graph/badge.svg?branch=master)](https://codecov.io/gh/penandlim/mgba-live-mcp)\n\nMCP server for persistent, live mGBA control. It is designed for agent workflows\nthat need to keep one emulator process running across multiple tool calls\n(input, Lua, memory reads, OAM/entity dumps, screenshots).\n\nIf you need one-shot/headless runs instead of persistent sessions, see\n[struktured-labs/mgba-mcp](https://github.com/struktured-labs/mgba-mcp).\n\n## What You Get (MCP Context)\n\n- Long-lived session lifecycle: `mgba_live_start`, `mgba_live_attach`,\n  `mgba_live_status`, `mgba_live_stop`\n- Metadata-only control: `mgba_live_input_tap`, `mgba_live_input_set`,\n  `mgba_live_input_clear`, `mgba_live_run_lua`, `mgba_live_start_with_lua`\n- Visual tools: `mgba_live_get_view`, `mgba_live_input_tap_and_view`,\n  `mgba_live_run_lua_and_view`, `mgba_live_start_with_lua_and_view`,\n  `mgba_live_export_screenshot`\n- Inspection: `mgba_live_read_memory`, `mgba_live_read_range`,\n  `mgba_live_dump_pointers`, `mgba_live_dump_oam`, `mgba_live_dump_entities`\n- Explicit session scoping for all single-session tools after `mgba_live_start`\n- `session_id` returned in every successful single-session response\n\nMCP reference: [docs/mcp-reference.md](docs/mcp-reference.md)\n\n## Quick Start (uvx)\n\n1. Run directly from PyPI with `uvx`:\n\n```bash\nuvx mgba-live-mcp\n```\n\n2. If you want to run from git (for unreleased changes), use:\n\n```bash\nuvx --from git+https://github.com/penandlim/mgba-live-mcp mgba-live-mcp\n```\n\n3. Register in an MCP client (Codex example):\n\n```toml\n[mcp_servers.mgba]\ncommand = \"uvx\"\nargs = [\"mgba-live-mcp\"]\n```\n\nGit fallback (if package is not yet published):\n\n```toml\n[mcp_servers.mgba]\ncommand = \"uvx\"\nargs = [\"--from\", \"git+https://github.com/penandlim/mgba-live-mcp\", \"mgba-live-mcp\"]\n```\n\n## Local Development\n\n1. Install dependencies for this repo:\n\n```bash\nuv sync\n```\n\n2. Provision the checksum-verified open-source tes…","publisher":null,"homepage":null,"repository":null,"version":"0.5.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mgba-live-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":1,"provenance":"derived"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"},{"slug":"knowledge.knowledge-graph","name":"Knowledge Graphs","confidence":0.791,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","knowledge"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mgba-live-mcp","registry":"pypi","observedAt":"2026-10-28T15:26:16.950Z","publishedAt":"2026-04-24T00:33:03.929160Z","latestVersion":"0.5.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mgba-live-mcp","url":"https://pypi.org/project/mgba-live-mcp/","firstSeenAt":"2026-09-10T05:23:22.150Z","fetchedAt":"2026-10-28T15:25:10.445Z","normalizedAt":"2026-10-28T15:25:10.445Z"}]},"firstSeenAt":"2026-09-10T05:23:22.150Z","updatedAt":"2026-10-28T15:26:16.950Z"}