get_avatar_nameLABSCO SUMMARY
Avatar parameters, discovered rather than guessed.
get_avatar_parameters reads what the loaded avatar actually exposes, so the assistant sets real parameters instead of inventing names — which is the difference between this and sending raw OSC yourself. Everything runs against your local VRChat instance over OSC, so the game has to be running with OSC switched on before any of it responds.
What it is
A bridge between an MCP client and VRChat over OSC. It reads the current avatar's parameters from the local configuration and sends movement, expression and chat messages to the running game.
What you get
- get_avatar_name and get_avatar_parameters — which avatar is loaded and which parameters it exposes
- set_avatar_parameter — write a specific avatar parameter
- set_emote_parameter — trigger an emote
- move_avatar and look_direction — move in a direction and control where the avatar is looking
- jump — make the avatar jump
- menu and voice — toggle the VRChat menu and voice features
- send_message — post to the VRChat chatbox
Requirements
Node.js 18 or higher, VRChat with OSC enabled, and Claude Desktop. Built from a clone with pnpm and linked with npm link, after which Claude Desktop launches it with npx. The OSC and WebSocket endpoints are configurable on the command line — --osc-send-port and --osc-send-ip for messages to VRChat, --osc-receive-port and --osc-receive-ip for messages back, plus --websocket-port and --websocket-host; --debug turns on detailed logging and --no-relay disables the relay server.
Setup effort
Build from source — git clone https://github.com/Krekun/vrchat-mcp-osc
USE CASES
01
Finding out what the current avatar can do
Read the avatar's name and the list of parameters it exposes before trying to drive it.
02
Reacting in character
Trigger an emote or set an expression parameter in response to what is happening.
03
Talking without typing
Send a line to the VRChat chatbox from the conversation you are already in.
04
Moving hands-free
Walk in a direction, turn to look at something, or jump.
10 tools
Listed in project docs. Your client may show a different list.
get_avatar_parametersset_avatar_parameterset_emote_parametermove_avatarlook_directionjumpmenuvoicesend_messageBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
Node.js 18 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/Krekun/vrchat-mcp-osc
cd vrchat-mcp-osc
pnpm install
pnpm -r build
npm linkMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"vrchat-mcp-osc": {
"command": "npx",
"args": [
"vrchat-mcp-osc"
]
}
}
}
