O que é VRChat MCP?
VRChat MCP, do usuário do GitHub sawa-zen, permite que um cliente MCP aja numa conta do VRChat pela API do VRChat documentada pela comunidade. As ferramentas listam amigos e notificações, buscam avatares, mundos e grupos, e executam ações: enviar pedidos de amizade, trocar de avatar, criar instâncias, entrar em grupos, adicionar favoritos e pedir convites.
É TypeScript com licença MIT publicado no npm como vrchat-mcp, com README em inglês, japonês e coreano. Tem cerca de 71 estrelas no GitHub e 33 downloads no npm na semana até 5 de novembro de 2026. A última versão no npm, a 0.15.0, saiu em 29 de abril de 2025; desde então só houve commits de atualização de dependências, o mais recente em 3 de fevereiro de 2026.
Como instalar VRChat MCP
npx vrchat-mcpVRChat MCP vale a pena?
VRChat MCP é um wrapper pequeno e direto. O README lista 17 ferramentas entre amigos, avatares, mundos, instâncias, grupos, favoritos, convites e notificações, cada uma uma chamada ao SDK comunitário vrchat que devolve o JSON bruto. Isso basta para perguntas como quais amigos estão online e para ações simples. Várias ferramentas alteram a sua conta em vez de só lê-la, então um erro do agente vira um pedido de amizade enviado, um avatar trocado ou a entrada num grupo em seu nome.
A autenticação é o principal risco. O README faz você entrar uma vez com um comando auxiliar e colar o cookie de autenticação resultante em VRCHAT_AUTH_TOKEN, e avisa que ele dura muito tempo; quem ler a sua configuração MCP pode usar a sua conta até ele expirar. O código também aceita VRCHAT_PASSWORD com VRCHAT_TOTP_SECRET, o que junta num só lugar a sua senha e o seu segredo de dois fatores e anula o propósito do login em duas etapas.
O risco da plataforma é igualmente real. As Creator Guidelines do VRChat dizem que a API não é documentada para uso público, que os endpoints mudam sem aviso e que aplicativos que causem transtorno serão moderados junto com seus usuários. Elas pedem limite de taxa e espera após erros, incluindo o HTTP 429; pela nossa leitura do código, não há lógica de nova tentativa nem de espera, e as falhas voltam como texto comum em vez de erros sinalizados. O servidor se identifica no cabeçalho User-Agent, como vrc-mcp/0.15.0 seguido do seu nome de usuário, embora as diretrizes também peçam dados de contato. Sem trabalho em recursos desde abril de 2025, uma mudança na API que o quebre provavelmente ficaria sem correção por um tempo.
Onde ele se destaca
Um frequentador do VRChat com uma lista grande de amigos
Ver quais amigos estão online e onde antes de colocar o headset
Peça ao assistente para listar os amigos online e suas instâncias e depois peça convite para uma delas. Gratuito; o custo é o risco do token guardado na configuração.
Um organizador de eventos no VRChat
Encontrar e salvar mundos candidatos para um encontro semanal
Busque mundos por palavra-chave, revise o JSON que o servidor devolve e adicione a seleção aos favoritos. Faça poucas chamadas, já que o VRChat pede limite de taxa.
Antes de decidir
- Configuração
- Rode npx vrchat-auth-token-checker para entrar e obter um token e depois adicione npx vrchat-mcp ao Claude Desktop ou a outro cliente com VRCHAT_USERNAME e VRCHAT_AUTH_TOKEN definidos. Alguns minutos.
- Integrações
- A API do VRChat documentada pela comunidade, pelo SDK do npm vrchat. Só stdio.
- Dados e privacidade
- Roda localmente e fala com os servidores do VRChat usando o seu cookie de sessão. Listas de amigos, notificações e mensagens de convite vão para o seu provedor de modelos. O token dura muito; trate o arquivo de configuração como uma senha.
- Custo em escala
- Gratuito sob MIT; não há plano pago nem versão hospedada.
- Limites
- API não oficial que pode mudar sem aviso; sem novas tentativas nem espera; erros retornam como texto comum. Última versão no npm: 0.15.0, de 29 de abril de 2025.
O que é bom
- 17 ferramentas para amigos, mundos, avatares, grupos e convites
- Instalação com uma linha de npx
- Envia um cabeçalho User-Agent com nome e versão
- README em inglês, japonês e coreano
O que não é
- Token de autenticação de longa duração guardado na configuração MCP
- Senha e segredo TOTP opcionais em variáveis de ambiente
- Baseado numa API não oficial que o VRChat não apoia
- Nenhuma versão desde a 0.15.0, de abril de 2025; sem limite de taxa
Ideal para
Frequentadores do VRChat que aceitam o risco para a conta e querem perguntar a um assistente quem está online, achar mundos ou gerenciar favoritos em linguagem comum.
VRChat MCP: perguntas frequentes
- VRChat MCP vale a pena?
- Funciona como uma ponte simples para a sua conta do VRChat, mas mal é mantido, depende de uma API que o VRChat não apoia e exige um token de sessão que vale tanto quanto a sua senha. Damos nota 3.0 de 5.
- Quanto custa VRChat MCP?
- Gratuito e de código aberto (MIT). Exige uma conta do VRChat.
- Quais são as desvantagens de VRChat MCP?
- Token de autenticação de longa duração guardado na configuração MCP; senha e segredo TOTP opcionais em variáveis de ambiente; baseado numa API não oficial que o VRChat não apoia; nenhuma versão desde a 0.15.0, de abril de 2025; sem limite de taxa.
- Para quem VRChat MCP é indicado?
- Frequentadores do VRChat que aceitam o risco para a conta e querem perguntar a um assistente quem está online, achar mundos ou gerenciar favoritos em linguagem comum.
- Quanto custa VRChat MCP para uma equipe ou em produção?
- Gratuito sob MIT; não há plano pago nem versão hospedada.
- VRChat MCP é seguro para dados da empresa?
- Roda localmente e fala com os servidores do VRChat usando o seu cookie de sessão. Listas de amigos, notificações e mensagens de convite vão para o seu provedor de modelos. O token dura muito; trate o arquivo de configuração como uma senha.
Respostas verificadas em 6 de nov. de 2026.