VRChat MCP
A local, single-user MCP server for managing your own VRChat account — friends, worlds, groups, events, avatars, invites, notifications, gallery images — plus read-only access to your local VRCX history, with curated tools and generated OpenAPI routers.
Auth: start local browser login, check auth status, log out (cookies kept in OS keychain or file).
Profile & status: read your profile (with optional paged groups), look up other users, edit bio/links/pronouns/icon/content filters/booping, get and set status + status description.
Friends: search by display name, paged friend list (online-only by default), summarized overview grouped by status/location with world and group info, and detailed friend profiles.
Worlds: search worlds, list favorited worlds, get world profiles by ID or name, summarize live world instances by access type and region.
Avatars: get avatar profiles, edit your own avatar metadata (name, description, release status, content tags) with dry-run preview.
Events: discover public events with category/tag filters, list upcoming events in a time window, search events, and create/update/follow/unfollow/delete group calendar events (recurrence-aware, with delete safety checks).
Groups: search groups, get group profiles, list members (single page or cached full snapshot), list roles and role templates, manage roles and member role assignments, list group events (all/get next/upcoming), summarize group instances, and list/create/update/delete group posts.
Favorites: read favorite records, groups, limits, and favorited avatars; add and remove favorites.
Instances & invites: create instances, link a group instance to an event, invite yourself or one/many users (here, location, or world+instance), invite users to groups, send friend requests, and send boops — bulk tools support batching, dry run, and retry/backoff.
Gallery: upload a validated static PNG to your gallery, list all gallery images, and delete a gallery image by file ID.
Notifications: list recent notifications with unread/type filters.
VRCX local history (read-only): detect VRCX DB and active user, read user/world/avatar memos, list recent world visits and instance sessions, and summarize or list shared sessions with a user (time spent, join count, last seen).
Generated API access:
vrchat_read,vrchat_write,vrchat_deleterouters for OpenAPI operations byoperationId, withvrchat_operations/vrchat_operation_detailsfor discovery.Local ops: cache invalidation, API config fetch, system time.
Safety controls: write tools on by default but can be disabled (
VRCHAT_MCP_ALLOW_WRITES=false), generated read/write surfaces can be toggled or narrowed to specific operation IDs, group writes can be allowlisted, and uploads restricted to configured absolute roots.
Provides tools for interacting with VRChat's API, enabling management of friends, worlds, groups, events, notifications, status, invites, and local VRCX history.
VRChat MCP
Unofficial local Model Context Protocol tools for VRChat friends, worlds, groups, events, notifications, status, invites, and local VRCX history.
VRChat MCP runs locally through stdio by default and also offers an opt-in loopback-only Streamable HTTP mode. Your VRChat auth cookies stay on your machine and default to your OS keychain, with file storage as the fallback when a keychain backend is unavailable. Curated write tools, generated read/write tools, and read-only VRCX local-history tools are available by default; use your MCP client or agent harness to approve account-changing tool calls.
This project is unofficial and is not affiliated with VRChat Inc.
Policy and Safety Boundaries
VRChat does not provide a public OAuth flow for third-party API applications. VRChat's Creator Guidelines say API applications should not request or store VRChat login credentials, auth tokens, or session data, should identify themselves with a clear User-Agent, should cache/back off instead of sending unmetered requests, and should not act on behalf of another user.
This project is therefore intended only as a local, user-controlled personal tool. Do not run it as a hosted/public MCP service, do not collect anyone else's credentials or cookies, do not automate spam or harassment, and do not use it to evade VRChat enforcement or moderation. Use write tools only for actions you would intentionally perform yourself in VRChat.
Related MCP server: rocketchat-mcp
Install
Requirements:
Node.js 24.15.0 or newer.
An MCP client that can run local stdio servers.
Native dependencies are installed for keychain and VRCX SQLite support (
keytar,better-sqlite3).
On headless Linux or containers without a keychain daemon such as libsecret, set VRCHAT_MCP_COOKIE_STORE=file for explicit persistent cookie storage.
The npm package is the normal install path:
npx -y @basicbit/vrchat-mcpThe server is also published to the official MCP Registry as io.github.BITRATE-Labs/vrchat-mcp.
MCP Client Config
Most clients use one of these shapes. No environment variables are required for the default setup.
OpenCode
OpenCode uses an array-valued command field.
Add this to ~/.config/opencode/opencode.json:
{
"mcp": {
"vrchat": {
"type": "local",
"command": ["npx", "-y", "@basicbit/vrchat-mcp"],
"enabled": true
}
}
}Claude Desktop, Cursor, Kiro, Roo, Windsurf
These clients usually split the executable into command plus args.
Use this in clients that expect an mcpServers object:
{
"mcpServers": {
"vrchat": {
"command": "npx",
"args": ["-y", "@basicbit/vrchat-mcp"]
}
}
}VS Code
VS Code uses a servers object instead of mcpServers.
Use this in .vscode/mcp.json:
{
"servers": {
"vrchat": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@basicbit/vrchat-mcp"]
}
}
}OpenAI Codex
Add this to ~/.codex/config.toml or .codex/config.toml:
[mcp_servers.vrchat]
command = "npx"
args = ["-y", "@basicbit/vrchat-mcp"]
startup_timeout_sec = 40If your Windows client cannot spawn npx directly, use cmd as the command and put /c, npx, -y, and @basicbit/vrchat-mcp in the argument list.
Local Streamable HTTP
Use native Streamable HTTP when an MCP client needs to connect to a long-running local server instead of spawning its own stdio child process. STDIO remains the default and recommended setup for ordinary desktop clients.
HTTP mode:
Binds only to
127.0.0.1.Uses the MCP endpoint
http://127.0.0.1:8765/mcpby default.Requires
Authorization: Bearer <token>on every MCP request.Supports stateful sessions, SSE notifications, resource subscriptions, and session termination.
Reaps abandoned sessions after 30 minutes of inactivity while preserving active response streams.
Shares one local VRChat login, cache, and pipeline connection across all connected HTTP clients.
Is not a hosted or multi-user mode.
Generate a secret and launch the server in PowerShell:
$env:VRCHAT_MCP_HTTP_BEARER_TOKEN = node -e "console.log(require('node:crypto').randomBytes(32).toString('hex'))"
npx -y @basicbit/vrchat-mcp --transport httpThen configure the MCP client to use http://127.0.0.1:8765/mcp and send the token from VRCHAT_MCP_HTTP_BEARER_TOKEN as a bearer token. Keep the token in an environment variable or secret store; do not put it in a URL or commit it to a client configuration.
CLI overrides:
npx -y @basicbit/vrchat-mcp --transport http --port 9000 --path /vrchat-mcpThe HTTP listener deliberately cannot bind to a LAN or public interface. Public hosting remains unsupported because VRChat does not provide the OAuth/account-isolation model needed for a hosted personal-account service.
Login
After adding the server to your MCP client, ask it to call vrchat_auth_begin. The tool returns a local browser login URL.
After logging in, call vrchat_auth_status to confirm the session. By default, cookies are stored in the OS keychain so the login survives MCP server restarts. If the OS keychain is unavailable, VRChat MCP falls back to file storage.
Do not ask another person to use this login flow for you. Do not send the local login URL, cookies, or session files to hosted tools or third-party services.
Useful auth tools:
vrchat_auth_begin: start local browser login.vrchat_auth_status: check whether the server is logged in.vrchat_auth_logout: clear the stored session.
Headless Login for Bot Accounts
Browser login needs a person. VRChat's twoFactorAuth cookie lasts 30 days, and changing an account's 2FA method revokes its session immediately, so an unattended deployment would otherwise need someone to log in again each time. For an account you own and operate with authenticator (TOTP) 2FA, such as a dedicated bot account, the server can log itself back in.
Set all three variables to turn it on. If any of them is missing or empty, nothing changes.
Variable | Use |
| VRChat username or email. |
| VRChat password. |
| Base32 authenticator secret. VRChat's space-grouped lowercase form is accepted too. |
When a VRChat API request returns 401, the server logs in once with the password and a freshly generated TOTP code, saves the new cookies to the configured cookie store, and retries the request once. If VRChat asks for an email code instead of TOTP, the server submits no code and returns the normal 401 error with a note to use vrchat_auth_begin. VRChat only reveals the 2FA method after the password step, so that still counts as a failed attempt for the backoff below.
Automatic logins are rate limited, and the limit is persisted so it holds when the host spawns a fresh server process for every call:
At most one automatic attempt every 10 minutes.
After a failed attempt (wrong password, rejected code, VRChat error) no automatic attempt for 60 minutes. An attempt that never recorded an outcome, for example because the process was killed mid-login, counts as failed.
While in cooldown, the tool error says so and gives the time of the next allowed attempt.
The record is
<cookie file>.autologin.json(mode 0600), beside the configured cookie file path. Keychain storage uses the same path. A short-lived.lockfile stops two processes from claiming the same attempt. If the record cannot be written, the server does not try to log in.With
VRCHAT_MCP_COOKIE_STORE=memorythere is no file, so the limit lives in memory and only applies within one process. That is much weaker: with a process per call, every process would log in. Usefilestorage for headless deployments.
The password, TOTP secret, generated codes, and cookie values are never logged or included in tool results or errors. vrchat_auth_logout still clears the session, but while the variables are set the next API call logs back in.
Some MCP hosts, OpenClaw included, replace the child environment with the server entry's env block instead of merging it into their own. Do not put the password or TOTP secret inline in the host config. Keep them in a root-owned env file with mode 0600 and point the host at a small wrapper script that loads the file and execs the server. The host must run the wrapper as a user that can read the file. Quote values that contain shell metacharacters. If the host's env block does not pass PATH, set it in the wrapper or use absolute paths.
#!/bin/sh
# /usr/local/bin/vrchat-mcp-bot
set -a
. /etc/vrchat-mcp/bot.env
set +a
exec vrchat-mcp "$@"# /etc/vrchat-mcp/bot.env (owner root, mode 0600)
VRCHAT_MCP_COOKIE_STORE=file
VRCHAT_MCP_COOKIE_FILE=/var/lib/vrchat-mcp/cookies.json
VRCHAT_MCP_USERNAME='bot-account'
VRCHAT_MCP_PASSWORD='...'
VRCHAT_MCP_TOTP_SECRET='abcd efgh ijkl mnop qrst uvwx yz23 4567'What You Can Ask
Examples:
Show my VRChat status and current location.Which friends are online, grouped by world?Search my friends for Alice and show their profile.Find public VRChat events happening today.Invite Bob to my current instance.Show recent worlds from my local VRCX history.Tools
VRChat MCP exposes curated tools plus generated read/write/delete routers by default. Curated tools cover common tasks with compact, agent-friendly inputs and outputs.
Common curated tools include:
vrchat_mevrchat_friends_overviewvrchat_friends_searchvrchat_friend_detailsvrchat_worlds_searchvrchat_group_profilevrchat_events_upcomingvrchat_notifications_recentvrchat_instance_link_eventvrchat_gallery_image_uploadvrchat_invitevrchat_group_invitevrchat_friend_requestvrchat_boopvrcx_instances_recent
Generated OpenAPI API-gap coverage uses three router tools:
vrchat_readfor available GET operations; passoperationIdplus path/query/header/cookie values underparams.vrchat_writefor available POST/PUT/PATCH operations; passoperationId,params, and JSON payloads underbody.vrchat_deletefor available DELETE operations; passoperationId,params, and optional JSON payloads underbody.
Use vrchat_operations to list available generated operation IDs and vrchat_operation_details for exact per-operation params/body schemas.
Generated read and write tools are enabled by default. VRCHAT_MCP_DISABLE_GENERATED_READ_TOOLS=true hides vrchat_read. VRCHAT_MCP_DISABLE_GENERATED_WRITE_TOOLS=true hides both vrchat_write and vrchat_delete, which share the generated-write switch. JSON config can also narrow either surface to specific operation IDs; generatedWriteTools.operationIds covers DELETE operations too, so a list holding only POST/PUT/PATCH IDs also hides vrchat_delete:
{
"generatedReadTools": { "enabled": true, "operationIds": ["getAvatarStyles"] },
"generatedWriteTools": { "enabled": true, "operationIds": ["selectAvatar"] }
}When an operationIds list is empty and that generated tool class is enabled, all generated operations in that class are available through its router except hard-skipped operations and operations with curated replacements. Prefer curated tools for common workflows, but generated routers keep the local server capable as the VRChat API evolves without duplicating known curated coverage or exposing generated endpoints this client cannot reliably call.
See docs/tools-guide.md for a short guide and docs/tools.md for the generated catalog.
Write Controls
Curated write tools and generated write tools for API gaps are enabled by default so the local MCP server is usable from the first run. Your MCP client or agent harness is expected to control tool-call permission, approval, and denial for account-changing actions.
To force read-only mode, add this env fragment inside the server entry for your MCP client:
{
"env": {
"VRCHAT_MCP_ALLOW_WRITES": "false"
}
}Only use write tools when you intend this local MCP server to perform VRChat account actions. Bulk social tools are capped and back off on 429s, but you are responsible for avoiding spam, harassment, or unwanted automation.
vrchat_gallery_image_upload uploads a validated static PNG to the signed-in account's personal gallery. It accepts only imagePath; group authorization is enforced later by the group post or event tool that attaches the returned file ID. Configure at least one absolute uploads.allowedRoots entry before using it.
For group write tools, you can restrict writes to specific group IDs with a JSON config file:
{
"groups": {
"allowlist": ["grp_abc123"]
}
}Then set VRCHAT_MCP_CONFIG_FILE to that file path in your MCP client config.
Configuration
Configuration is optional. Defaults cover normal local use.
Common environment variables:
Variable | Use |
| Path to a JSON config file. |
| Descriptive user agent for VRChat API requests. |
|
|
|
|
| Cookie file path when |
| Username for headless login. |
| Password for headless login. |
| Base32 TOTP secret for headless login. |
| Set to |
| Absolute roots allowed for local PNG uploads. |
|
|
| Required 32+ character secret for HTTP mode. |
| Loopback HTTP port. Defaults to |
| MCP endpoint path. Defaults to |
| Maximum concurrent HTTP sessions. Defaults to |
| Per-client HTTP request limit. Defaults to |
| Abandoned-session timeout. Defaults to |
Example JSON config:
{
"auth": { "cookieStore": "file" },
"writes": { "allow": false },
"http": {
"port": 8765,
"path": "/mcp",
"maxSessions": 8,
"rateLimitPerMinute": 300,
"sessionIdleTimeoutMs": 1800000
},
"groups": { "allowlist": ["grp_abc123"] },
"uploads": { "allowedRoots": ["C:\\Users\\you\\Pictures\\VRChat Uploads"] },
"cache": { "enabled": true },
"vrcx": { "enabled": true }
}See src/config/defaults.json for all defaults.
Local Development
git clone https://github.com/BITRATE-Labs/vrchat-mcp.git
cd vrchat-mcp
npm install
npm run build
npm run checkUseful scripts:
npm run dev: run fromsrc/index.ts.npm run start: run the built server fromdist/.npm run dev -- --transport http: run the local Streamable HTTP server from source.npm run start -- --transport http: run the built local Streamable HTTP server.npm run mcp:login: start login through the local harness.npm run mcp:status: check auth through the local harness.npm run smoke:live: run the opt-in live smoke check.npm run generate:tools-docs: regeneratedocs/tools.md.npm run generate:schemas: regenerate OpenAPI schemas.npm run mcpb:build: build a local MCPB bundle undermcpb/.
Live E2E tests and LLM evals are opt-in. See docs/evals.md for details.
License
MIT. See LICENSE.
Available Tools
73 toolsvrchat_auth_beginA
Begin login flow via local browser UI.
Inputs: no named parameters. Returns: url
vrchat_auth_logoutA
Logout and clear session.
Inputs: no named parameters. Returns: loggedIn
vrchat_auth_statusDRead-only
Auth status.
Inputs: no named parameters. Returns: loggedIn
vrchat_avatar_profileCRead-only
Get an avatar profile by avatarId (read-only).
Inputs: avatarId (required), fields, compact, maxArrayLength. Returns: stale, avatar, avatarId, vrcxMemo
vrchat_avatar_updateADestructive
Edit your own avatar metadata: name, description, releaseStatus, and content tags. Asset fields (assetUrl, unityPackageUrl, unityVersion, version) are unreachable — a bad value there repoints the avatar at the wrong build with no undo. Content tags: content_sex, content_adult, content_violence, content_gore, content_horror. Tags merge rather than replace, so author tags survive; clearContentTags strips every content_* tag, including ones this build does not know. CAUTION — releaseStatus is risky in BOTH directions; confirm intent before changing it. Going public can expose a creator’s work against their terms, leak a private avatar, or breach VRChat’s content policy depending on what the avatar contains. Going private breaks the avatar for everyone currently wearing it. Use dryRun to preview.
Inputs: avatar (required), name, dryRun, addTags, +4 more. Returns: name, tags, dryRun, status, +2 more
vrchat_boopB
Send boops to one or many users. Users may be usr_ ids or exact display names.
Inputs: user, retry, users, dryRun, +4 more. Returns: sent, dryRun, failed, status, +5 more
vrchat_cache_invalidateC
Invalidate cached data (local-only).
Inputs: key, area, scope. Returns: key, area, scope, cleared, +1 more
vrchat_config_getCRead-only
Fetch API config (read-only).
Inputs: page, fields, compact, includeMeta, +1 more. Returns: url, data, page
vrchat_deleteADestructive
Call an available generated VRChat DELETE operation by operationId. Use vrchat_operations and vrchat_operation_details to discover params/body.
Inputs: operationId (required), body, params, options, +1 more. Returns: data
vrchat_event_createC
Create a group calendar event.
Inputs: title (required), endsAt (required), groupId (required), startsAt (required), +18 more. Returns: event, result, status
vrchat_event_deleteBDestructive
Delete a group calendar event after verifying whether the target is an occurrence or series.
Inputs: groupId (required), calendarId (required), targetKind (required). Returns: event, result, status
vrchat_event_followC
Follow or unfollow a group calendar event.
Inputs: groupId (required), calendarId (required), isFollowing (required). Returns: event, result, status
vrchat_events_discoverCRead-only
Discover public calendar events with optional category/tag filters (read-only).
Inputs: tags, scope, fields, compact, +12 more. Returns: page, scope, events, maxItems, +5 more
vrchat_events_searchCRead-only
Search calendar events by term (read-only).
Inputs: searchTerm (required), fields, compact, maxItems, +4 more. Returns: page, events, maxPages, pageSize, +4 more
vrchat_events_upcomingBRead-only
List calendar events in the upcoming window (read-only). Defaults to the next 7 days.
Inputs: from, fields, compact, maxItems, +4 more. Returns: to, from, events, maxItems, +6 more
vrchat_event_updateC
Edit the specified event. Recurring targets require targetKind.
Inputs: groupId (required), calendarId (required), tags, title, +19 more. Returns: event, result, status
vrchat_favorite_addC
Add a user, avatar, or world to a favorite group.
Inputs: tags (required), type (required), targetId (required). Returns: result, status, favorite
vrchat_favorite_removeADestructive
Remove a favorite by favorite record ID. Use vrchat_favorites to look up favoriteRecordId first.
Inputs: favoriteRecordId (required). Returns: result, status, favorite
vrchat_favoritesBRead-only
Read favorites, favorite groups, limits, or favorited avatars with compact outputs (read-only).
Inputs: tag, sort, type, view, +16 more. Returns: page, view, group, notes, +5 more
vrchat_friend_detailsBRead-only
Get a friend's profile, status, and location details by display name or userId (read-only).
Inputs: name, userId, includeOffline. Returns: group, world, friend, profile, +2 more
vrchat_friend_requestC
Send friend requests to one or many users. Users may be usr_ ids or exact display names.
Inputs: user, retry, users, dryRun, +1 more. Returns: sent, dryRun, failed, status, +5 more
vrchat_friends_listBRead-only
List friends with cache-backed pagination (read-only). Defaults to online-only; set includeOffline=true to include offline friends.
Inputs: maxItems, maxPages, pageSize, detailLevel, +1 more. Returns: stale, friends, maxItems, maxPages, +6 more
vrchat_friends_overviewBRead-only
Summarize friends by status and location with enriched world/group info (read-only).
Inputs: status, maxLocations, statusFilter, includeOffline, +2 more. Returns: stale, totals, segments, locations, +14 more
vrchat_friends_searchCRead-only
Search friends by display name (read-only).
Inputs: query (required), maxResults, includeOffline. Returns: query, matches, totalFriends, includeOffline
vrchat_gallery_image_deleteADestructive
Delete one exact image file owned by the signed-in account and tagged gallery. Existing posts, events, or other references may be affected. Does not check usage; the caller decides what to preserve.
Inputs: fileId (required). Returns: fileId, status
vrchat_gallery_imagesARead-only
List every image in the signed-in account gallery with compact metadata and total count. Fetches all pages internally; reuse fileId when attaching existing artwork.
Inputs: no named parameters. Returns: total, images
vrchat_gallery_image_uploadA
Upload a validated static PNG to the signed-in VRChat account gallery. This does not attach the image to a group post or event.
Inputs: imagePath (required). Returns: name, image, fileId, ownerId, +3 more
vrchat_group_event_getCRead-only
Get a single group calendar event (read-only).
Inputs: calendarId (required), fields, compact, groupId, +2 more. Returns: event, stale, groupId, calendarId
vrchat_group_event_nextCRead-only
Get the next upcoming calendar event for a group (read-only).
Inputs: fields, compact, groupId, shortCode, +1 more. Returns: event, stale, groupId
vrchat_group_events_listCRead-only
List group calendar events (read-only).
Inputs: date, fields, compact, groupId, +5 more. Returns: date, page, stale, events, +6 more
vrchat_group_events_upcomingCRead-only
List upcoming group events in a time window (read-only).
Inputs: from, fields, compact, groupId, +6 more. Returns: to, from, stale, events, +8 more
vrchat_group_instances_overviewCRead-only
Summarize active group instances (read-only).
Inputs: groupId, shortCode, maxInstances. Returns: stale, groupId, instances, totalMembers, +1 more
vrchat_group_inviteB
Invite one or many users to a group. Users may be usr_ ids or exact display names. Requires groupId or shortCode. confirmOverrideBlock defaults false; pass true only to override an existing target-user block.
Inputs: user, retry, users, dryRun, +4 more. Returns: sent, dryRun, failed, status, +6 more
vrchat_group_membersARead-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).
Inputs: sort, view, offset, roleId, +3 more. Returns: page, view, stale, groupId, +3 more
vrchat_group_post_createA
Create a group post (announcement). Does not notify members unless sendNotification is true.
Inputs: text (required), title (required), visibility (required), groupId, +4 more. Returns: post, postId, status, groupId, +1 more
vrchat_group_post_deleteADestructive
Delete a group post. Members already notified about it are not un-notified.
Inputs: postId (required), groupId, shortCode. Returns: post, postId, status, groupId, +1 more
vrchat_group_posts_recentCRead-only
List recent posts for a group (read-only).
Inputs: groupId, maxItems, maxPages, pageSize, +2 more. Returns: page, posts, stale, groupId, +4 more
vrchat_group_post_updateA
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.
Inputs: postId (required), text, title, groupId, +5 more. Returns: post, postId, status, groupId, +1 more
vrchat_group_profileBRead-only
Get a group profile by groupId or shortCode (read-only).
Inputs: fields, compact, groupId, shortCode, +1 more. Returns: group, stale, groupId
vrchat_group_rolesBRead-only
List group roles or role templates with compact fields (read-only).
Inputs: view, groupId, shortCode. Returns: view, roles, groupId, templates, +1 more
vrchat_group_roles_manageADestructive
Assign/remove member roles or create/update/delete group role definitions.
Inputs: action (required), name, order, roleId, +7 more. Returns: role, roles, action, userId, +3 more
vrchat_groups_searchCRead-only
Search groups by name or shortCode (read-only).
Inputs: query (required), maxItems, maxPages, pageSize. Returns: page, query, stale, groups, +4 more
vrchat_instance_createD
Create a new instance.
Inputs: type (required), region (required), worldId (required), ageGate, +14 more. Returns: status, instance
vrchat_instance_link_eventA
Link an allowlisted group instance to its event without notifying.
Inputs: groupId (required), worldId (required), calendarId (required), instanceId (required). Returns: status, groupId, location, calendarId, +2 more
vrchat_inviteB
Invite yourself or one/many users to an instance. Users may be usr_ ids or exact display names. Destination is here=true, a full location like "wrld_:instance", or worldId+instanceId. A bare instanceId is not accepted: VRChat needs the worldId and rejects the stripped form.
Inputs: here, self, user, retry, +8 more. Returns: sent, dryRun, failed, status, +7 more
vrchat_invite_selfC
Invite yourself to an instance (low-risk write).
Inputs: worldId, location, instanceId. Returns: status, notification
vrchat_invite_userC
Invite a user to an instance.
Inputs: userId (required), worldId, location, instanceId, +1 more. Returns: status, notification
vrchat_invite_user_to_meA
Invite a user to your current instance. Requires only the target userId; resolves your current location automatically. If you only have a display name, run vrchat_friends_search first to get userId.
Inputs: userId (required), messageSlot. Returns: status, userId, worldId, location, +2 more
vrchat_meBRead-only
Get your profile (read-only). Use view=presence/summary/profile presets; provide fields to override. Optionally include a paged list of your groups.
Inputs: view, fields, compact, groupOffset, +4 more. Returns: user, groups, userId, vrcxMemo
vrchat_notifications_recentCRead-only
List recent notifications (read-only).
Inputs: type, after, maxItems, maxPages, +2 more. Returns: page, stale, maxPages, pageSize, +3 more
vrchat_operation_detailsARead-only
Look up exact OpenAPI params and request body schema for a VRChat operationId.
Inputs: operationId (required). Returns: path, method, summary, parameters, +7 more
vrchat_operationsARead-only
List VRChat OpenAPI operationIds and generated-tool availability for vrchat_read/vrchat_write/vrchat_delete.
Inputs: kind, view, limit, query. Returns: total, truncated, operations
vrchat_profile_updateB
Update your profile fields (bio, bioLinks, pronouns, userIcon, booping, content filters). Status is preserved automatically.
Inputs: bio, bioLinks, pronouns, userIcon, +2 more. Returns: user, userId
vrchat_readARead-only
Call an available generated VRChat GET operation by operationId. Use vrchat_operations and vrchat_operation_details to discover params.
Inputs: operationId (required), page, fields, params, +3 more. Returns: data
vrchat_status_getARead-only
Get your current status + description (read-only).
Inputs: no named parameters. Returns: status, userId, statusDescription
vrchat_status_page_overviewCRead-only
Compact VRChat status-page overview: up/down state, graph min/max/current values, unresolved + recent incidents, and active + upcoming maintenance (read-only).
Inputs: maxItems, recentHours, includeGraphs. Returns: page, notes, graphs, status, +6 more
vrchat_status_setA
Set your status + description (write). Requires status or color (blue/green/orange/red); if both are provided they must agree. Defaults to current user.
Inputs: color, status, userId, description. Returns: status, userId, statusDescription
vrchat_system_timeCRead-only
Get current system time (read-only).
Inputs: page, fields, compact, includeMeta, +1 more. Returns: url, data, page
vrchat_user_groupsCRead-only
List a user's groups (id + name only, cache-backed).
Inputs: offset, userId, maxPages, pageSize, +1 more. Returns: page, stale, groups, userId, +4 more
vrchat_user_profileCRead-only
Get a user profile (read-only). Optionally include a paged list of the user's groups.
Inputs: fields, userId, compact, username, +5 more. Returns: user, groups, userId, vrcxMemo
vrchat_world_instances_overviewCRead-only
Summarize world instances by access type and region (read-only).
Inputs: name, worldId. Returns: stale, worldId, instances, resolvedBy
vrchat_world_profileCRead-only
Get a world profile by worldId or name (read-only).
Inputs: name, fields, compact, worldId, +1 more. Returns: stale, world, worldId, vrcxMemo, +1 more
vrchat_worlds_favoritesCRead-only
List favorited worlds with compact results (read-only).
Inputs: tag, sort, notag, order, +12 more. Returns: page, notes, stale, total, +1 more
vrchat_worlds_searchCRead-only
Search worlds by name and return compact results (read-only).
Inputs: query (required), tag, sort, notag, +11 more. Returns: page, notes, query, stale, +2 more
vrchat_writeA
Call an available generated VRChat POST/PUT/PATCH operation by operationId. Use vrchat_operations and vrchat_operation_details to discover params/body.
Inputs: operationId (required), body, params, options, +1 more. Returns: data
vrcx_db_statusARead-only
Detect VRCX on this machine and report database path, active user, and DB version (read-only).
Inputs: no named parameters. Returns: db, enabled, worldDb, vrcxJson, +5 more
vrcx_gamelog_world_visits_recentBRead-only
List recent world visits from the VRCX gamelog (read-only). This reflects your local VRChat/VRCX activity history.
Inputs: limit, daysBack. Returns: from, limit, total, visits, +1 more
vrcx_instances_recentBRead-only
List recent instance sessions for your active VRCX account (read-only). Derived from VRCX gamelog OnPlayerLeft entries.
Inputs: limit, daysBack. Returns: from, limit, total, sessions, +2 more
vrcx_memos_avatar_getCRead-only
Get a VRCX avatar memo by avatarId (read-only).
Inputs: avatarId (required). Returns: memo, avatarId, editedAt
vrcx_memos_user_getCRead-only
Get a VRCX user memo by userId (read-only).
Inputs: userId (required). Returns: memo, userId, editedAt
vrcx_memos_world_getBRead-only
Get a VRCX world memo by worldId (read-only).
Inputs: worldId (required). Returns: memo, worldId, editedAt
vrcx_user_relationship_sessionsARead-only
List recent shared instance sessions with a user from VRCX logs (read-only). Use this for deep history; results are limited by default.
Inputs: limit, userId, displayName. Returns: limit, query, total, sessions, +3 more
vrcx_user_relationship_summaryBRead-only
Summarize your relationship history with a user using VRCX logs: time spent, join count, and last seen (read-only).
Inputs: userId, displayName. Returns: query, hasData, lastSeen, joinCount, +5 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 73 tools
There are multiple overlapping tools, especially around invites (vrchat_invite, vrchat_invite_user, vrchat_invite_user_to_me, vrchat_invite_self), events (vrchat_event_* vs vrchat_group_event_*), favorites (vrchat_favorites vs vrchat_worlds_favorites), and profile lookups (vrchat_me vs vrchat_user_profile vs vrchat_friend_details). The generic vrchat_read/write/delete tools also overlap every specific wrapper, making it unclear when to use the specialized tool versus the passthrough.
All names are lowercase snake_case and use clear vrchat_/vrcx_ prefixes, but the internal patterns are mixed: some are noun_verb (vrchat_friends_list), some verb_noun (vrchat_invite_self), some resource-only (vrchat_favorites), and pluralization is inconsistent (event vs events, friend vs friends). It remains readable, but the ordering and entity naming are not predictable.
With 73 tools, the surface is far beyond a well-scoped set and includes many redundant wrappers plus generic OpenAPI passthroughs. The size may reflect VRChat's broad API, but the set does not demonstrate that each tool earns its place over the generic vrchat_read/write/delete mechanisms.
Coverage is broad across auth, users, friends, groups, events, worlds, avatars, instances, invites, notifications, favorites, gallery images, and VRCX local history. The generic vrchat_read/write/delete and operation-discovery tools provide fallback coverage for unlisted OpenAPI operations, though some direct convenience operations are missing.
Maintenance
Related MCP Connectors
The official Planning Center MCP server for interacting with your ministry's data.
The official MCP Server for the Mux API
MCP server to assist with JxBrowser development.
Ovanek MCP: Model Context Protocol server for Ovanek platform tools; writes are dry-run by default.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceA basic MCP server implementation for testing purposes. Communicates via stdio and is designed to work with MCP-compliant clients.-
- AlicenseAqualityCmaintenanceMCP server for Rocket.Chat — messages, DMs, search, files, and channels over stdio1238 PyPI1MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for the Steam Web API, exposing your game library, playtime, achievements, friends, wishlist, and the Steam store to MCP clients over stdio.-
- AlicenseCqualityCmaintenanceConnects an ER:LC private server's API to MCP clients so users can read live players, locations, vehicles, staff, queues, logs, bans, and emergency calls, and send remote server commands. It covers API v2 with v1 compatibility, structured error and rate-limit handling, and works over local stdio transport.171MIT