{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_9xsjjxrktudb","handle":"gbdocs-mcp","url":"https://wellknown.network/agents/gbdocs-mcp","links":{"self":"https://wellknown.network/agents/gbdocs-mcp/record.json","html":"https://wellknown.network/agents/gbdocs-mcp","markdown":"https://wellknown.network/agents/gbdocs-mcp/record.md","api":"https://wellknown.network/api/v1/agents/gbdocs-mcp","status":"https://wellknown.network/api/v1/agents/gbdocs-mcp/status","claim":"https://wellknown.network/agents/gbdocs-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/gbdocs-mcp/claim.json","badge":"https://wellknown.network/agents/gbdocs-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/gbdocs-mcp/history","tools":"https://wellknown.network/api/v1/agents/gbdocs-mcp/tools"},"ard":{"identifier":"urn:air::server:gbdocs-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"gbdocs-mcp","summary":"MCP server exposing the Game Boy Pan Docs as structured, citable lookups for decompilation work","description":"# gbdocs-mcp\n\n[![CI](https://github.com/Nighthawk42/gbdocs-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Nighthawk42/gbdocs-mcp/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/gbdocs-mcp.svg)](https://pypi.org/project/gbdocs-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/gbdocs-mcp.svg)](https://pypi.org/project/gbdocs-mcp/)\n[![License](https://img.shields.io/pypi/l/gbdocs-mcp.svg)](LICENSE)\n\nAn MCP server that turns the Game Boy [Pan Docs](https://gbdev.io/pandocs) into precise,\nlow-token, **citable** lookups for decompilation work.\n\nInstead of grepping 456 KB of markdown, an agent can ask directly:\n\n- *What is `$FF41`?* → `gb_lookup_register`\n- *What does `ld a,$91 / ldh [rLCDC],a` configure?* → `gb_decode_register_value`\n- *What does a write to `$2000` do on MBC1?* → `gb_mbc_decode_write`\n- *What is opcode `$CB 7C`?* → `gb_decode_opcode`\n- *What register state does my ROM inherit from the boot ROM?* → `gb_boot_state`\n\nTwo rules shape every response:\n\n1. **Nothing is fabricated.** Each response carries a `source` block naming the page,\n   section and `https://gbdev.io/pandocs/...` URL it came from. Where Pan Docs does not\n   cover something (opcode cycle counts, for instance), the server says so.\n2. **`pandocs/` is never modified.** The docs are read live at startup, so a\n   `git pull` inside the clone updates the server with no rebuild.\n\n## Install\n\nThe Pan Docs markdown ships inside the package, so there is nothing else to download.\n\n```sh\npip install gbdocs-mcp                # or: uv tool install gbdocs-mcp\npip install \"gbdocs-mcp[semantic]\"    # adds embedding-backed search (pulls in torch)\n```\n\nRegister with Claude Code:\n\n```sh\nclaude mcp add gbdocs -- uvx gbdocs-mcp\n```\n\n<details>\n<summary>Or with any MCP client, via <code>mcpServers</code> config</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"gbdocs\": {\n      \"command\": \"uvx\",\n      \"args\": [\"gbdocs-mcp\"]\n    }\n  }\n}\n```\n</details>\n\n### From source\n\n```sh\ngit clone htt…","publisher":{"name":"Nighthawk42","url":null},"homepage":"https://github.com/Nighthawk42/gbdocs-mcp","repository":"https://github.com/Nighthawk42/gbdocs-mcp/blob/main/CHANGELOG.md","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["decompilation","game-boy","gameboy","gbdev","mcp","model-context-protocol","pandocs","retro","reverse-engineering","sm83"],"pricing":null,"endpoints":[{"url":"pypi:gbdocs-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"documents.conversion","name":"Document Conversion","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","documents"],"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":"gbdocs-mcp","registry":"pypi","observedAt":"2026-09-15T15:24:35.850Z","publishedAt":"2026-08-14T06:24:24.454163Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"gbdocs-mcp","url":"https://pypi.org/project/gbdocs-mcp/","firstSeenAt":"2026-09-09T16:23:21.507Z","fetchedAt":"2026-09-15T15:22:41.532Z","normalizedAt":"2026-09-15T15:22:41.532Z"}]},"firstSeenAt":"2026-09-09T16:23:21.507Z","updatedAt":"2026-09-15T15:24:35.850Z"}