VRChat MCP

# VRChat MCP

This project is developing a Model Context Protocol (MCP) server that can retrieve information from the VRChat API.
The implementation is based on https://github.com/GLips/Figma-Context-MCP.

## About the User
The user is a frontend engineer. They can code better than you, but due to time constraints, they are asking for your help. So let's think and create together.

## Development Approach

- Be sure to read the README
  - It contains features and implementation methods that we want to support in the future.
- If you are given a link to documentation, be sure to read it using the browser action.
- If possible, write tests before implementation. Use them to verify the specifications.
- Since this is an OSS project, all documentation including README should be written in English.
- When implementing new tools:
  - Update the package version (minor version for new features)
  - Update README.md, README.ja.md, and README.ko.md to reflect the new supported features
  - Update version in both package.json and src/main.ts to match the new version

## Reference Information for Implementation

- VRChat SDK: https://github.com/vrchatapi/vrchatapi-javascript?tab=readme-ov-file
- VRChat API Documentation: https://vrchatapi.github.io/docs/api/
- modelcontextprotocol/sdk: https://github.com/modelcontextprotocol/typescript-sdk

## VRChat Tag Specifications

Tags in VRChat are used to grant access, assign restrictions, or attach metadata to various objects such as worlds, users, and avatars. Here are the key specifications:

### Tag Format
- Tags are simple strings grouped in a string array
- Tags are commonly prefixed with a namespace designating the type of tag
- Format: `namespace_type:value`

### Tag Types
1. Admin Tags
   - Start with `admin_`
   - Assigned manually by staff members
   - Example: `admin_moderator`

2. System Tags
   - Start with `system_`
   - Automatically assigned by the system
   - Example: `system_trust_basic`

### Tag Usage
- Tags can be used to:
  - Grant access to features
  - Assign restrictions
  - Add metadata to objects
  - Define user roles and permissions
  - Mark system status and properties

### Implementation Notes
- When working with tags, always validate the tag format
- Consider tag namespaces when implementing tag-related features
- Handle both admin and system tags appropriately
- Be aware that some tags may affect user permissions and access levels