MCPgee
MCPgee
MCPgeeMCPgee

VRChat

v1.0.0•APIs•stable

A Model Context Protocol server that allows AI assistants to interact with the VRChat API, enabling retrieval of user information, friends lists, and other VRChat data through a standardized interface.

aiclaudeclinemcpvrchat
Share:
57
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is VRChat?

VRChat is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that allows ai assistants to interact with the vrchat api, enabling retrieval of user information, friends lists, and other vrchat data through a standardized interface....

A Model Context Protocol server that allows AI assistants to interact with the VRChat API, enabling retrieval of user information, friends lists, and other VRChat data through a standardized interface.

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol server that allows AI assistants to

Use Cases

VRChat data retrieval and user management
Social VR platform automation
sawa-zen

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 7, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx vrchat-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use VRChat

VRChat MCP Server is a TypeScript MCP server that connects AI assistants to the VRChat API, enabling retrieval and management of user data, friends lists, avatars, worlds, instances, groups, favorites, invites, and notifications through natural language prompts. It authenticates with VRChat using a username and long-lived auth token, and exposes a rich set of tools for exploring and automating VRChat social and platform interactions. VRChat enthusiasts and developers use it to query their VR social graph, manage invites, and automate repetitive platform tasks from Claude or other MCP clients.

Prerequisites

  • Node.js 18 or later installed
  • A VRChat account with username and password
  • A VRChat auth token (obtained via the included npx vrchat-auth-token-checker utility)
  • An MCP-compatible client such as Claude Desktop or Cline
1

Obtain your VRChat authentication token

Run the auth token helper utility. It prompts for your VRChat username, password, and optional 2FA code, then prints your auth token. Store it securely — it has a long lifetime.

npx vrchat-auth-token-checker
2

Note your VRChat username

You will need both your VRChat username (the login name, not the display name) and the auth token from the previous step for the MCP configuration.

3

Add the server to your Claude Desktop configuration

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows) and add the vrchat-mcp entry.

{
  "mcpServers": {
    "vrchat-mcp": {
      "command": "npx",
      "args": ["vrchat-mcp"],
      "env": {
        "VRCHAT_USERNAME": "your-vrchat-username",
        "VRCHAT_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}
4

Restart Claude Desktop

Quit and reopen Claude Desktop to load the new MCP server configuration. The VRChat tools should become available in the tool list.

5

Verify the connection

Ask Claude 'Who are my VRChat friends currently online?' to confirm the server is connecting to the VRChat API successfully.

VRChat Examples

Client configuration

Complete claude_desktop_config.json entry for the VRChat MCP server with credentials.

{
  "mcpServers": {
    "vrchat-mcp": {
      "command": "npx",
      "args": ["vrchat-mcp"],
      "env": {
        "VRCHAT_USERNAME": "your-vrchat-username",
        "VRCHAT_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}

Prompts to try

Example prompts for exploring VRChat data and automating platform interactions.

- "Show me my current VRChat friends list and who is online."
- "Search for worlds with 'horror' in the name and list the top 5 results."
- "Find my favorited worlds and show their current instance counts."
- "Search for the avatar named 'CyberFox' and switch to it."
- "Send an invite to my friend [username] to join my current instance."
- "Show all my unread VRChat notifications."

Troubleshooting VRChat

Authentication fails with 'invalid credentials' error

Re-run 'npx vrchat-auth-token-checker' to generate a fresh auth token. Tokens can expire or be invalidated when you change your VRChat password. Update VRCHAT_AUTH_TOKEN in your MCP config with the new token.

npx vrchat-mcp fails to start or times out

Run 'npx vrchat-mcp' manually in a terminal with VRCHAT_USERNAME and VRCHAT_AUTH_TOKEN exported to see error output. Ensure Node.js 18+ is installed and that your network can reach the VRChat API (vrchat.com).

2FA prompt appears but auth token checker does not accept the code

Enter the 6-digit TOTP code from your authenticator app immediately after the prompt — TOTP codes expire in 30 seconds. If using email 2FA, check your inbox for the VRChat verification email and enter the code quickly.

Frequently Asked Questions about VRChat

What is VRChat?

VRChat is a Model Context Protocol (MCP) server that model context protocol server that allows ai assistants to interact with the vrchat api, enabling retrieval of user information, friends lists, and other vrchat data through a standardized interface. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install VRChat?

Follow the installation instructions on the VRChat GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with VRChat?

VRChat works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is VRChat free to use?

Yes, VRChat is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

VRChat Alternatives — Similar APIs Servers

Looking for alternatives to VRChat? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.

Kong

★ 43.4k

🦍 The API and AI Gateway

API Mega List

★ 5.4k

This GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪

Fetch

★ 5.4k

Fetch web content and convert to markdown for AI consumption

Fusio

★ 2.1k

Self-Hosted API Management for Builders

Korean Law

★ 1.8k

국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools

RuleGo

★ 1.5k

⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

APIsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "vrchat-mcp-server": { "command": "npx", "args": ["-y", "vrchat-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use VRChat?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides