VRChat MCP Server

Instructions

Implementation Reference

• src/tools/groups.ts:12-30 (handler)

  The async handler function that authenticates the VRChat client, joins the specified group using groupsApi.joinGroup, and returns the JSON response or an error message.

  async (args) => {
    try {
      await vrchatClient.auth()
      const response = await vrchatClient.groupsApi.joinGroup(args.groupId)
      return {
        content: [{
          type: 'text',
          text: JSON.stringify(response.data, null, 2)
        }]
      }
    } catch (error) {
      return {
        content: [{
          type: 'text',
          text: 'Failed to join group: ' + error
        }]
      }
    }
  }

• src/tools/groups.ts:9-11 (schema)

  Zod input schema defining the required 'groupId' parameter as a string.

  {
    groupId: z.string().describe('Must be a valid group ID')
  },

• src/tools/groups.ts:7-31 (registration)

  Direct registration of the 'vrchat_join_group' tool on the MCP server, including description, input schema, and inline handler.

    'vrchat_join_group',
    'Join a VRChat group by ID',
    {
      groupId: z.string().describe('Must be a valid group ID')
    },
    async (args) => {
      try {
        await vrchatClient.auth()
        const response = await vrchatClient.groupsApi.joinGroup(args.groupId)
        return {
          content: [{
            type: 'text',
            text: JSON.stringify(response.data, null, 2)
          }]
        }
      } catch (error) {
        return {
          content: [{
            type: 'text',
            text: 'Failed to join group: ' + error
          }]
        }
      }
    }
  )

• src/main.ts:34-34 (registration)

  Invocation of createGroupsTools in the main server setup, which registers the vrchat_join_group tool among others.

  createGroupsTools(server, vrchatClient)