@basicbit/vrchat-mcp 0.1.7 → 0.1.9

package/docs/tools.md

@@ -1,6 +1,6 @@
 # Tool Catalog (generated)
 
-Generated: 2026-06-08T08:31:09.652Z
+Generated: 2026-07-30T16:08:13.535Z
 
 Spec: VRChat API Documentation (1.20.7)
 
@@ -3865,7 +3865,7 @@ Output schema:
 ```
 
 ### vrchat_group_members
-List group members by userId + displayName (read-only). (read-only)
+List one page of compact group members by default. Use view=all only when a complete, cached snapshot is required (read-only, capped at 10,000). (read-only)
 
 Input schema:
 
@@ -3875,36 +3875,41 @@ Input schema:
   "type": "object",
   "properties": {
     "groupId": {
-      "type": "string"
+      "type": "string",
+      "description": "Exact group ID. Provide groupId or shortCode."
     },
     "shortCode": {
-      "type": "string"
+      "type": "string",
+      "description": "Exact group short code. Provide groupId or shortCode."
     },
     "roleId": {
-      "type": "string"
+      "type": "string",
+      "description": "Only include members with this role."
     },
     "sort": {
-      "type": "string"
-    },
-    "pageSize": {
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 100
+      "type": "string",
+      "description": "VRChat group-member sort expression."
     },
-    "maxPages": {
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 200
+    "view": {
+      "description": "page fetches one bounded API page; all explicitly loads and caches a rate-aware snapshot capped at 10,000 members.",
+      "default": "page",
+      "type": "string",
+      "enum": [
+        "page",
+        "all"
+      ]
     },
-    "maxItems": {
+    "pageSize": {
       "type": "integer",
       "minimum": 1,
-      "maximum": 9007199254740991
+      "maximum": 100,
+      "description": "Members to fetch when view=page. Ignored when view=all."
     },
     "offset": {
       "type": "integer",
       "minimum": 0,
-      "maximum": 9007199254740991
+      "maximum": 9007199254740991,
+      "description": "Starting member offset when view=page. Ignored when view=all."
     }
   },
   "additionalProperties": false
@@ -3921,7 +3926,14 @@ Output schema:
     "groupId": {
       "type": "string"
     },
-    "totalMembers": {
+    "view": {
+      "type": "string",
+      "enum": [
+        "page",
+        "all"
+      ]
+    },
+    "returnedMembers": {
       "type": "integer",
       "minimum": 0,
       "maximum": 9007199254740991
@@ -3989,9 +4001,411 @@ Output schema:
   },
   "required": [
     "groupId",
-    "totalMembers",
+    "view",
+    "returnedMembers",
     "truncated",
-    "stale"
+    "stale",
+    "members"
+  ],
+  "additionalProperties": false
+}
+```
+
+### vrchat_group_post_create
+Create a group post (announcement). Does not notify members unless sendNotification is true. (write)
+
+Input schema:
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Post title."
+    },
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Post body text."
+    },
+    "visibility": {
+      "type": "string",
+      "enum": [
+        "group",
+        "public"
+      ],
+      "description": "group restricts the post to members; public shows it on the group page."
+    },
+    "roleIds": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Restrict the post to these group roles. Omit to show it to everyone who can see the post."
+    },
+    "imageId": {
+      "type": "string",
+      "description": "Existing VRChat file ID to attach as the post image."
+    },
+    "sendNotification": {
+      "description": "Notify group members. Defaults to false; set true only when the post warrants a ping.",
+      "default": false,
+      "type": "boolean"
+    },
+    "groupId": {
+      "type": "string",
+      "description": "Exact group ID. Provide groupId or shortCode."
+    },
+    "shortCode": {
+      "type": "string",
+      "description": "Exact group short code. Provide groupId or shortCode."
+    }
+  },
+  "required": [
+    "title",
+    "text",
+    "visibility"
+  ],
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "status": {
+      "type": "string",
+      "enum": [
+        "created",
+        "updated",
+        "deleted"
+      ]
+    },
+    "groupId": {
+      "type": "string"
+    },
+    "postId": {
+      "type": "string"
+    },
+    "mergedFromExisting": {
+      "type": "boolean"
+    },
+    "post": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "text": {
+              "type": "string"
+            },
+            "createdAt": {
+              "type": "string"
+            },
+            "updatedAt": {
+              "type": "string"
+            },
+            "authorId": {
+              "type": "string"
+            },
+            "visibility": {
+              "type": "string"
+            },
+            "roleIds": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "imageId": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "status",
+    "groupId"
+  ],
+  "additionalProperties": false
+}
+```
+
+### vrchat_group_post_delete
+Delete a group post. Members already notified about it are not un-notified. (write, destructive)
+
+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."
+    },
+    "postId": {
+      "type": "string",
+      "description": "Post ID to delete."
+    }
+  },
+  "required": [
+    "postId"
+  ],
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "status": {
+      "type": "string",
+      "enum": [
+        "created",
+        "updated",
+        "deleted"
+      ]
+    },
+    "groupId": {
+      "type": "string"
+    },
+    "postId": {
+      "type": "string"
+    },
+    "mergedFromExisting": {
+      "type": "boolean"
+    },
+    "post": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "text": {
+              "type": "string"
+            },
+            "createdAt": {
+              "type": "string"
+            },
+            "updatedAt": {
+              "type": "string"
+            },
+            "authorId": {
+              "type": "string"
+            },
+            "visibility": {
+              "type": "string"
+            },
+            "roleIds": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "imageId": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "status",
+    "groupId"
+  ],
+  "additionalProperties": false
+}
+```
+
+### vrchat_group_post_update
+Update a group post. Omitted fields keep their current values; pass roleIds: [] to clear role restrictions. VRChat replaces the whole post on edit, so this reads the most recent 300 posts to recover the fields you did not send. If the post is older than that window, supplying title, text, and visibility still lets the edit land, but it cannot preserve roleIds or imageId and the response reports mergedFromExisting: false. Editing does not re-notify members unless sendNotification is true. (write)
+
+Input schema:
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Post title."
+    },
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Post body text."
+    },
+    "visibility": {
+      "type": "string",
+      "enum": [
+        "group",
+        "public"
+      ],
+      "description": "group restricts the post to members; public shows it on the group page."
+    },
+    "roleIds": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Replace the post role restrictions. Omit to keep the current roles; pass an empty array to clear them."
+    },
+    "imageId": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Replace the post image. Omit to keep the current image; pass null to remove it."
+    },
+    "sendNotification": {
+      "description": "Re-notify group members about the edit. Defaults to false so corrections stay quiet.",
+      "default": false,
+      "type": "boolean"
+    },
+    "groupId": {
+      "type": "string",
+      "description": "Exact group ID. Provide groupId or shortCode."
+    },
+    "shortCode": {
+      "type": "string",
+      "description": "Exact group short code. Provide groupId or shortCode."
+    },
+    "postId": {
+      "type": "string",
+      "description": "Post ID from vrchat_group_post_create or vrchat_group_posts_recent. Shaped like a notification ID (not_...)."
+    }
+  },
+  "required": [
+    "postId"
+  ],
+  "additionalProperties": false
+}
+```
+
+Output schema:
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "status": {
+      "type": "string",
+      "enum": [
+        "created",
+        "updated",
+        "deleted"
+      ]
+    },
+    "groupId": {
+      "type": "string"
+    },
+    "postId": {
+      "type": "string"
+    },
+    "mergedFromExisting": {
+      "type": "boolean"
+    },
+    "post": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "text": {
+              "type": "string"
+            },
+            "createdAt": {
+              "type": "string"
+            },
+            "updatedAt": {
+              "type": "string"
+            },
+            "authorId": {
+              "type": "string"
+            },
+            "visibility": {
+              "type": "string"
+            },
+            "roleIds": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "imageId": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "status",
+    "groupId"
   ],
   "additionalProperties": false
 }
@@ -4128,6 +4542,15 @@ Output schema:
           },
           "visibility": {
             "type": "string"
+          },
+          "roleIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "imageId": {
+            "type": "string"
           }
         },
         "required": [
@@ -9140,7 +9563,6 @@ Generated output uses a compact envelope; exact API response content is under `d
 - `acceptFriendRequest` via `vrchat_write` (PUT /auth/user/notifications/{notificationId}/accept) - Write VRChat API: Accept Friend Request.
 - `acknowledgeNotificationV2` via `vrchat_write` (POST /notifications/{notificationId}/see) - Write VRChat API: Acknowledge NotificationV2.
 - `addGroupGalleryImage` via `vrchat_write` (POST /groups/{groupId}/galleries/{groupGalleryId}/images) - Write VRChat API: Add Group Gallery Image.
-- `addGroupPost` via `vrchat_write` (POST /groups/{groupId}/posts) - Write VRChat API: Create a post in a Group.
 - `addTags` via `vrchat_write` (POST /users/{userId}/addTags) - Write VRChat API: Add User Tags.
 - `banGroupMember` via `vrchat_write` (POST /groups/{groupId}/bans) - Write VRChat API: Ban Group Member.
 - `blockGroup` via `vrchat_write` (POST /groups/{groupId}/block) - Write VRChat API: Block Group.
@@ -9190,7 +9612,6 @@ Generated output uses a compact envelope; exact API response content is under `d
 - `updateGroup` via `vrchat_write` (PUT /groups/{groupId}) - Write VRChat API: Update Group.
 - `updateGroupGallery` via `vrchat_write` (PUT /groups/{groupId}/galleries/{groupGalleryId}) - Write VRChat API: Update Group Gallery.
 - `updateGroupMember` via `vrchat_write` (PUT /groups/{groupId}/members/{userId}) - Write VRChat API: Update Group Member.
-- `updateGroupPost` via `vrchat_write` (PUT /groups/{groupId}/posts/{notificationId}) - Write VRChat API: Edits a Group post.
 - `updateGroupRepresentation` via `vrchat_write` (PUT /groups/{groupId}/representation) - Write VRChat API: Update Group Representation.
 - `updateInviteMessage` via `vrchat_write` (PUT /message/{userId}/{messageType}/{slot}) - Write VRChat API: Update Invite Message.
 - `updateOwnInventoryItem` via `vrchat_write` (PUT /inventory/{inventoryItemId}) - Write VRChat API: Update Own Inventory Item.
@@ -9289,7 +9710,6 @@ Generated output uses a compact envelope; exact API response content is under `d
 - `deleteGroupGallery` via `vrchat_delete` (DELETE /groups/{groupId}/galleries/{groupGalleryId}) - Write VRChat API: Delete Group Gallery.
 - `deleteGroupGalleryImage` via `vrchat_delete` (DELETE /groups/{groupId}/galleries/{groupGalleryId}/images/{groupGalleryImageId}) - Write VRChat API: Delete Group Gallery Image.
 - `deleteGroupInvite` via `vrchat_delete` (DELETE /groups/{groupId}/invites/{userId}) - Write VRChat API: Delete User Invite.
-- `deleteGroupPost` via `vrchat_delete` (DELETE /groups/{groupId}/posts/{notificationId}) - Write VRChat API: Delete a Group post.
 - `deleteImpostor` via `vrchat_delete` (DELETE /avatars/{avatarId}/impostor) - Write VRChat API: Delete generated Impostor.
 - `deleteModerationReport` via `vrchat_delete` (DELETE /moderationReports/{moderationReportId}) - Write VRChat API: Delete Moderation Report.
 - `deleteNotificationV2` via `vrchat_delete` (DELETE /notifications/{notificationId}) - Write VRChat API: Delete NotificationV2.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basicbit/vrchat-mcp",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "mcpName": "io.github.BASIC-BIT/vrchat-mcp",
   "description": "MCP server for VRChat friends, worlds, groups, events, notifications, and VRCX history.",
   "type": "module",
@@ -88,7 +88,8 @@
     "@apidevtools/json-schema-ref-parser": "^15.3.5",
     "@eslint/js": "^10.0.1",
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^25.9.2",
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.1.1",
     "@typescript-eslint/eslint-plugin": "^8.50.0",
     "@typescript-eslint/parser": "^8.50.0",
     "@vitest/coverage-v8": "^4.0.16",
@@ -107,7 +108,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "better-sqlite3": "^12.6.2",
+    "better-sqlite3": "^13.0.1",
+    "express": "^5.2.1",
     "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.7",
+  "version": "0.1.9",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@basicbit/vrchat-mcp",
-      "version": "0.1.7",
+      "version": "0.1.9",
       "transport": {
         "type": "stdio"
       },