@basicbit/vrchat-mcp 0.1.11 → 0.1.12

package/docs/tools.md

@@ -1,6 +1,6 @@
 # Tool Catalog (generated)
 
-Generated: 2026-08-31T20:31:03.518Z
+Generated: 2026-09-01T09:25:52.032Z
 
 Spec: VRChat API Documentation (1.20.8)
 
@@ -3725,6 +3725,125 @@ Output schema:
 }
 ```
 
+### vrchat_group_image_upload
+Upload a static PNG to the signed-in VRChat account gallery for later use by an allowlisted group. This does not attach the image to a group post or event. (write)
+
+Input schema:
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "groupId": {
+      "type": "string",
+      "description": "Exact group ID. Provide groupId or shortCode."
+    },
+    "shortCode": {
+      "type": "string",
+      "description": "Exact group short code. Provide groupId or shortCode."
+    },
+    "imagePath": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Absolute path to a static PNG inside uploads.allowedRoots. The image must be 65-2048 pixels per side and no larger than 10 MiB."
+    }
+  },
+  "required": [
+    "imagePath"
+  ],
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "status": {
+      "type": "string",
+      "const": "uploaded"
+    },
+    "groupId": {
+      "type": "string"
+    },
+    "fileId": {
+      "type": "string"
+    },
+    "image": {
+      "type": "object",
+      "properties": {
+        "fileName": {
+          "type": "string"
+        },
+        "byteSize": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "width": {
+          "type": "integer",
+          "minimum": 65,
+          "maximum": 2048
+        },
+        "height": {
+          "type": "integer",
+          "minimum": 65,
+          "maximum": 2048
+        }
+      },
+      "required": [
+        "fileName",
+        "byteSize",
+        "width",
+        "height"
+      ],
+      "additionalProperties": false
+    },
+    "file": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "mimeType": {
+          "type": "string"
+        },
+        "extension": {
+          "type": "string"
+        },
+        "ownerId": {
+          "type": "string"
+        },
+        "version": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "status",
+    "groupId",
+    "fileId",
+    "image",
+    "file"
+  ],
+  "additionalProperties": false
+}
+```
+
 ### vrchat_group_instances_overview
 Summarize active group instances (read-only). (read-only)
 
@@ -9738,9 +9857,7 @@ Generated output uses a compact envelope; exact API response content is under `d
 - `updateProp` via `vrchat_write` (PUT /props/{propId}) - Write VRChat API: Update Prop.
 - `updateTiliaTos` via `vrchat_write` (PUT /user/{userId}/tilia/tos) - Write VRChat API: Update Tilia TOS Agreement Status.
 - `updateUserNote` via `vrchat_write` (POST /userNotes) - Write VRChat API: Update User Note.
-- `uploadGalleryImage` via `vrchat_write` (POST /gallery) - Write VRChat API: Upload gallery image.
 - `uploadIcon` via `vrchat_write` (POST /icon) - Write VRChat API: Upload icon.
-- `uploadImage` via `vrchat_write` (POST /file/image) - Write VRChat API: Upload gallery image, icon, emoji or sticker.
 - `uploadPrint` via `vrchat_write` (POST /prints) - Write VRChat API: Upload Print.
 - `verify2FA` via `vrchat_write` (POST /auth/twofactorauth/totp/verify) - Write VRChat API: Verify 2FA code.
 - `verify2FAEmailCode` via `vrchat_write` (POST /auth/twofactorauth/emailotp/verify) - Write VRChat API: Verify 2FA email code.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basicbit/vrchat-mcp",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "mcpName": "io.github.BASIC-BIT/vrchat-mcp",
   "description": "MCP server for VRChat friends, worlds, groups, events, notifications, and VRCX history.",
   "type": "module",
@@ -111,6 +111,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "better-sqlite3": "^13.0.1",
     "express": "^5.2.1",
+    "fast-png": "^8.0.0",
     "keytar": "^7.9.0",
     "tough-cookie": "^6.0.0",
     "undici": "^8.4.0",

package/server.json

@@ -8,12 +8,12 @@
     "source": "github",
     "id": "1122295987"
   },
-  "version": "0.1.11",
+  "version": "0.1.12",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@basicbit/vrchat-mcp",
-      "version": "0.1.11",
+      "version": "0.1.12",
       "transport": {
         "type": "stdio"
       },
@@ -64,6 +64,13 @@
           "default": "true",
           "isRequired": false,
           "isSecret": false
+        },
+        {
+          "name": "VRCHAT_MCP_UPLOAD_ROOTS",
+          "description": "Absolute directories from which local PNG uploads may be read. Separate multiple roots with the platform path delimiter.",
+          "format": "string",
+          "isRequired": false,
+          "isSecret": false
         }
       ]
     }