From 441603c8ae0567a3fd538d661c400110df728009 Mon Sep 17 00:00:00 2001
From: Bucamp Axle <47558509+Axle-Bucamp@users.noreply.github.com>
Date: Tue, 29 Jul 2025 05:39:49 -0700
Subject: [PATCH] Create mcp-config.json

mcp config to run the cli as AI asssisted tool, TODO bridge it with prebuild docker
---
 mcp-config.json | 149 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 149 insertions(+)
 create mode 100644 mcp-config.json

diff --git a/mcp-config.json b/mcp-config.json
new file mode 100644
index 0000000000..e6cfa103f8
--- /dev/null
+++ b/mcp-config.json
@@ -0,0 +1,149 @@
+{
+  "name": "zeldaret_mm_tools",
+  "description": "Run Zelda decompilation tools for Majora's Mask using the Docker environment provided by zeldaret/mm. Supports extracting assets, compiling, and verifying against the original ROM. Designed for automation via Camel Owl Agent.",
+  "dockerfile_path": "./Dockerfile",
+  "entrypoint": "/zeldaret/mm/tools/natural.sh",
+  "commands": [
+    {
+      "name": "diff",
+      "description": "Compares the original assembly extracted from the ROM instruction-for-instruction with what the code you have written compiles to.",
+      "script": "./tools/diff.py",
+      "parameters": [
+        {
+          "name": "function_symbol",
+          "description": "The function symbol name to diff (e.g., ObjTree_Init)",
+          "type": "string",
+          "required": true
+        },
+        {
+          "name": "flags",
+          "description": "Optional flags for diff.py (e.g., -mwo, -mwo3, -mwob)",
+          "type": "string",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "m2ctx",
+      "description": "Generates the context for a C file to help mips_to_c. Writes to a file called ctx.c in the root directory of the repo.",
+      "script": "./tools/m2ctx.py",
+      "parameters": [
+        {
+          "name": "c_file_path",
+          "description": "Path to the C file",
+          "type": "string",
+          "required": true
+        }
+      ]
+    },
+    {
+      "name": "actor_symbols",
+      "description": "Takes a VRAM or VROM address to get overlay file and offset for an Actor.",
+      "script": "./tools/overlayhelpers/actor_symbols.py",
+      "parameters": [
+        {
+          "name": "address",
+          "description": "VRAM or VROM address",
+          "type": "string",
+          "required": true
+        }
+      ]
+    },
+    {
+      "name": "first_diff",
+      "description": "Gives the addresses of first difference in the ROM, the difference, and a count of how many bytes differ, or if the whole ROM is shifted.",
+      "script": "./tools/first_diff.py",
+      "parameters": []
+    },
+    {
+      "name": "sym_info",
+      "description": "Finds ROM, VRAM, and file information for a given symbol (function or variable name) using the map file.",
+      "script": "./tools/sym_info.py",
+      "parameters": [
+        {
+          "name": "symbol_name",
+          "description": "The symbol name (e.g., ObjTree_Init)",
+          "type": "string",
+          "required": true
+        }
+      ]
+    },
+    {
+      "name": "extract_assets",
+      "description": "Uses ZAPD to extract assets from the baserom.",
+      "script": "./extract_assets.py",
+      "parameters": []
+    },
+    {
+      "name": "assist",
+      "description": "Searches for similar functions to the one you are passing, and it tells you which one are decompiled. Can also search for similar functions for every function in a given overlay.",
+      "script": "./tools/assist.py",
+      "parameters": [
+        {
+          "name": "function_or_overlay_name",
+          "description": "Function name or overlay name",
+          "type": "string",
+          "required": true
+        }
+      ]
+    },
+    {
+      "name": "get_actor_sizes",
+      "description": "Generates a list of actors with various statistics about their function sizes.",
+      "script": "./tools/get_actor_sizes.py",
+      "parameters": [
+        {
+          "name": "flags",
+          "description": "Optional flags for get_actor_sizes.py",
+          "type": "string",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "progress",
+      "description": "Gives the progress output that the website uses.",
+      "script": "./tools/progress.py",
+      "parameters": []
+    },
+    {
+      "name": "regconvert",
+      "description": "Converts mips2c's gRegEditor->data[n] output (or a raw offset) into the appropriate variable in the REG pages. Can also be run on a file to mass-convert them.",
+      "script": "./tools/regconvert.py",
+      "parameters": [
+        {
+          "name": "input",
+          "description": "Input (gRegEditor->data[n] output, raw offset, or file path)",
+          "type": "string",
+          "required": true
+        }
+      ]
+    },
+    {
+      "name": "rename_global_asm",
+      "description": "Renames single-function assembly files in asm/non_matchings when the function they contain has been renamed.",
+      "script": "./tools/rename_global_asm.py",
+      "parameters": []
+    },
+    {
+      "name": "rename_sym",
+      "description": "Renames a symbol throughout the codebase. Use with caution as it has no sanity checks.",
+      "script": "./tools/rename_sym.sh",
+      "parameters": [
+        {
+          "name": "old_symbol_name",
+          "description": "The old symbol name",
+          "type": "string",
+          "required": true
+        },
+        {
+          "name": "new_symbol_name",
+          "description": "The new symbol name",
+          "type": "string",
+          "required": true
+        }
+      ]
+    }
+  ]
+}
+