@weppy/roblox-mcp 1.2.3 → 1.3.1

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Roblox MCP server and tools for AI-powered game development",
-    "version": "1.2.3"
+    "version": "1.3.1"
   },
   "plugins": [
     {
       "name": "weppy-roblox-mcp",
       "source": "./plugins/weppy-roblox-mcp",
       "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-      "version": "1.2.3",
+      "version": "1.3.1",
       "author": {
         "name": "hope1026"
       },

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,60 @@
+name: Bug Report
+description: Something isn't working correctly
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Before reporting, check [Troubleshooting](https://github.com/hope1026/roblox-mcp/blob/main/docs/en/troubleshooting.md)
+        and [Discussions](https://github.com/hope1026/roblox-mcp/discussions).
+  - type: input
+    id: os
+    attributes:
+      label: OS
+      placeholder: "macOS 14 / Windows 11"
+    validations:
+      required: true
+  - type: input
+    id: node
+    attributes:
+      label: Node.js version
+      placeholder: "node --version output"
+    validations:
+      required: true
+  - type: input
+    id: ai-client
+    attributes:
+      label: AI client
+      placeholder: "Claude Code 1.x / Cursor 0.4x / Codex CLI"
+    validations:
+      required: true
+  - type: input
+    id: plugin-version
+    attributes:
+      label: Plugin / MCP server version
+      placeholder: "v1.3.1"
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs (if any)
+      render: shell

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,30 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      placeholder: "e.g. I can't easily do X with the current tools"
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+    validations:
+      required: true
+  - type: dropdown
+    id: tier
+    attributes:
+      label: Which tier would this apply to?
+      options:
+        - Basic
+        - Pro
+        - Both
+        - Not sure
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context

package/.github/ISSUE_TEMPLATE/install_help.yml

@@ -0,0 +1,48 @@
+name: Install Help
+description: Having trouble installing or connecting
+labels: ["question", "installation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **First:** check the [Installation Guide](https://github.com/hope1026/roblox-mcp/blob/main/docs/en/installation/README.md)
+        and [Troubleshooting](https://github.com/hope1026/roblox-mcp/blob/main/docs/en/troubleshooting.md).
+        For general questions, use [Discussions](https://github.com/hope1026/roblox-mcp/discussions) instead.
+  - type: dropdown
+    id: ai-client
+    attributes:
+      label: AI client
+      options:
+        - Claude Code
+        - Claude Desktop
+        - Cursor
+        - Codex CLI
+        - Gemini CLI
+        - Other
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: OS
+      placeholder: "macOS 14 / Windows 11"
+    validations:
+      required: true
+  - type: input
+    id: node
+    attributes:
+      label: Node.js version
+      placeholder: "node --version output"
+    validations:
+      required: true
+  - type: textarea
+    id: issue
+    attributes:
+      label: What's happening?
+      placeholder: "Describe the problem and any error messages"
+    validations:
+      required: true
+  - type: textarea
+    id: tried
+    attributes:
+      label: What have you tried?

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,16 @@
+## What does this PR do?
+
+<!-- Brief description of the change -->
+
+## Type of change
+
+- [ ] Documentation improvement
+- [ ] Example prompt or cookbook addition
+- [ ] Bug fix
+- [ ] Other
+
+## Checklist
+
+- [ ] I've read [CONTRIBUTING.md](../CONTRIBUTING.md)
+- [ ] Changes are limited to docs or examples (plugin source is not in this repo)
+- [ ] Links and paths are correct

package/.github/workflows/deploy-docs.yml

@@ -0,0 +1,41 @@
+name: Deploy docs to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'README.md'
+      - 'llms.txt'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/CHANGELOG.md

@@ -5,11 +5,59 @@ All notable changes to this project will be documented in this file.
 
 
 
+## [1.3.1] - 2026-03-07
 
+### Improvements
 
+- Improve sync robustness during rapid consecutive file changes
+- Enhance incremental change processor to reduce false-positive conflict detection
+- Strengthen sync index integrity checks on startup and reconnect
+- Improve LRU cache eviction to prevent stale place data after session switch
 
+### Bug Fixes
+
+- Fix sync stall when file watcher emits duplicate events for the same path
+- Fix reverse sync occasionally skipping files with identical hashes but different timestamps
+- Fix collision suffix (`~N`) not reindexing correctly after instance rename
+- Fix sync-init phase hanging when workspace contains deeply nested empty containers
+
+### Documentation
+
+- Restructure README for faster install path (Quick Install and compatibility table at top)
+- Add troubleshooting guide
+- Add compatibility matrix (supported clients, system requirements, Basic vs Pro)
+- Add `llms.txt` for AI crawler discovery
+- Add community health files: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, SUPPORT
+- Add GitHub issue templates (bug report, feature request, install help)
+
+
+## [1.3.0] - 2026-03-06
+
+### Breaking Changes
+
+- Sync file format now uses nested directory structure for all objects — each instance is represented as its own directory (e.g., `Part/Part.props.json` instead of flat files)
+- Duplicate sibling instances are now distinguished using `~N` suffix encoding (Odd-Count Tilde Rule) — e.g., `Part~1/`, `Part~2/`, `Part~3/`
+- Existing sync data will be regenerated automatically (no migration from v1)
+
+### Improvements
+
+- Enhance sync stability and performance for bidirectional file synchronization
+- Improve sync child indexing and collision handling
+- Refine analytics tracking for tool usage
+
+### Bug Fixes
+
+- Improve error handling and resilience during MCP tool execution
+- Fix license token cache and Pro auth flow issues
+- Resolve sync errors on concurrent file changes
+- Fix duplicated instance name handling in sync index
+- Fix various edge cases in sync change processing
 
+### Plugin
 
+- Improve plugin icons and UI refinements
+- Clean up unused files and modules
+- General plugin stability improvements
 
 
 ## [1.2.3] - 2026-03-02

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,29 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity, level of experience, nationality, personal appearance, race, religion, or sexual identity.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy toward other community members
+
+Examples of unacceptable behavior:
+
+- Harassment, trolling, or personal attacks
+- Publishing others' private information without permission
+- Other conduct which could reasonably be considered inappropriate
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting the maintainer via [GitHub Discussions](https://github.com/hope1026/roblox-mcp/discussions). All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

package/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing to Roblox MCP
+
+## Bug Reports
+
+Use the [Bug Report issue template](https://github.com/hope1026/roblox-mcp/issues/new?template=bug_report.yml).
+
+Include:
+- OS and Node.js version (`node --version`)
+- Roblox Studio version
+- AI client and version
+- Steps to reproduce
+- Expected vs actual behavior
+- Error logs if available
+
+## Feature Requests
+
+Use the [Feature Request template](https://github.com/hope1026/roblox-mcp/issues/new?template=feature_request.yml).
+
+## Questions & Install Help
+
+Use [GitHub Discussions](https://github.com/hope1026/roblox-mcp/discussions) — not Issues — for questions and install help.
+
+## Pull Requests
+
+This repository distributes the MCP server and plugin. The plugin source is not included here.
+
+PRs for **documentation improvements** and **example prompts** are welcome:
+
+1. Fork the repository
+2. Create a branch: `git checkout -b docs/your-improvement`
+3. Make your changes
+4. Open a Pull Request with a clear description
+
+## Code of Conduct
+
+Please read and follow the [Code of Conduct](CODE_OF_CONDUCT.md).

package/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
-**English** | [한국어](docs/ko/README.md) | [日本語](docs/ja/README.md) | [Español](docs/es/README.md) | [Português](docs/pt-br/README.md) | [Bahasa Indonesia](docs/id/README.md)
+> MCP server and plugin for Roblox Studio — control scripts, terrain, assets, and lighting with Claude Code, Cursor, Codex, and Gemini.
 
-> Tell AI what you want, and it happens in Roblox Studio.
+**English** | [한국어](docs/ko/README.md) | [日本語](docs/ja/README.md) | [Español](docs/es/README.md) | [Português](docs/pt-br/README.md) | [Bahasa Indonesia](docs/id/README.md)
 
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
-## Core Capabilities
+## Quick Install (5 minutes)
+
+**Step 1** — Install the Roblox Studio plugin (bridge between Studio and AI):
+[Plugin Installation Guide](docs/en/installation/roblox-plugin.md)
+
+**Step 2** — Register the MCP server with your AI app:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| AI App | Guide |
+|--------|-------|
+| Claude Code | [Setup](docs/en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [Setup](docs/en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [Setup](docs/en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [Setup](docs/en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [Setup](docs/en/installation/ai-apps/gemini-cli.md) |
+
+> Any MCP-compatible AI client works. The server command is `npx -y @weppy/roblox-mcp`.
+
+## Compatibility
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**Requirements:** Node.js 18+, Roblox Studio, Windows 10+ or macOS 12+
+
+## What It Does
 
 ### 1) MCP Tools: Direct execution in Studio from natural language
 
-The first pillar of Roblox MCP is **MCP tool execution**.
 AI can directly handle scripts, instances, properties, terrain, lighting, assets, audio, and animation inside Studio.
 
 - "Add particles + sound + cooldown when the player jumps."
@@ -21,7 +49,6 @@ This is not just code generation. It is **executable, production-oriented action
 
 ### 2) Sync: Keep full project context stable for AI
 
-The second pillar is **Project Sync**.
 AI works from a synchronized local mirror, so multi-file updates stay consistent.
 
 ![Sync workflow — Studio and local files synchronized in real time](docs/assets/screenshots/sync.png)
@@ -29,36 +56,27 @@ AI works from a synchronized local mirror, so multi-file updates stay consistent
 - Basic: one-way sync (Studio -> Local)
 - Pro: bidirectional sync + per-type Direction/Apply Mode + history + multi-place
 
-You keep source-of-truth clear and avoid losing change context.
-
-## Immediate Value
+## Why It Matters
 
 - Compress repetitive work: turn many manual edits into one request
 - Change related files together: not just one target file
 - Lower risk: rely on sync state and history before applying changes
 - Better token efficiency (Pro): reduce round trips with bulk actions
 
-## Detailed Docs
+## Docs
 
-- [Tools Overview](docs/en/tools/overview.md)
+- [Installation Guide](docs/en/installation/README.md)
+- [Tools Reference](docs/en/tools/overview.md)
 - [Sync Deep Dive](docs/en/sync/overview.md)
-
-## Getting Started
-
-Installation is complete in two steps:
-
-1. **Install Roblox Studio Plugin** — Acts as a bridge between Studio and AI
-2. **Register MCP Server with AI App** — Configure your AI app to recognize Roblox MCP
-
-Takes just 5 minutes. 👉 [View Installation Guide](docs/en/installation/README.md)
+- [Compatibility](docs/compatibility.md)
+- [Troubleshooting](docs/troubleshooting.md)
 
 ## Pro Upgrade
 
 Bidirectional Sync, advanced build capabilities, and AI token efficiency — all in one upgrade.
 
-👉 [Pro Upgrade Guide](docs/en/pro-upgrade.md)
+[Pro Upgrade Guide](docs/en/pro-upgrade.md)
 
-## Links
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Issue Reports](https://github.com/hope1026/roblox-mcp/issues)
+[GitHub Issues](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/SECURITY.md

@@ -0,0 +1,28 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| 1.x (latest) | ✅ |
+| < 1.0 | ❌ |
+
+## Reporting a Vulnerability
+
+Do **not** open a public GitHub issue for security vulnerabilities.
+
+Report security issues via [GitHub Issues](https://github.com/hope1026/roblox-mcp/issues/new) with the title prefixed `[SECURITY]`, or contact the maintainer via [GitHub Discussions](https://github.com/hope1026/roblox-mcp/discussions).
+
+We will respond within 72 hours and aim to release a fix within 14 days for confirmed vulnerabilities.
+
+## Scope
+
+- MCP server HTTP bridge (localhost:3002)
+- Plugin authentication and session token handling
+- License server communication
+
+## Out of Scope
+
+- Roblox Studio itself
+- Third-party AI client security
+- Issues requiring physical access to the machine

package/SUPPORT.md

@@ -0,0 +1,26 @@
+# Support
+
+## Documentation
+
+- [Installation Guide](docs/en/installation/README.md)
+- [Tools Reference](docs/en/tools/overview.md)
+- [Sync Deep Dive](docs/en/sync/overview.md)
+- [Compatibility](docs/en/compatibility.md)
+- [Troubleshooting](docs/en/troubleshooting.md)
+
+## Community Help
+
+For questions and install issues, use [GitHub Discussions](https://github.com/hope1026/roblox-mcp/discussions).
+
+Please include:
+- Your OS and Node.js version
+- AI client you're using
+- What you've already tried
+
+## Bug Reports
+
+For confirmed bugs, open an [Issue](https://github.com/hope1026/roblox-mcp/issues/new?template=bug_report.yml).
+
+## Pro Users
+
+Pro users can reach out via the contact information provided in your Gumroad receipt.

package/docs/compatibility.md

@@ -0,0 +1,44 @@
+# Compatibility
+
+## Supported AI Clients
+
+| Client | Basic | Pro | Setup guide |
+|--------|:-----:|:---:|-------------|
+| Claude Code | ✅ | ✅ | [Guide](en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | ✅ | ✅ | [Guide](en/installation/ai-apps/claude-app.md) |
+| Cursor | ✅ | ✅ | MCP config: `npx -y @weppy/roblox-mcp` |
+| Codex CLI | ✅ | ✅ | [Guide](en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | ✅ | ✅ | [Guide](en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | ✅ | ✅ | [Guide](en/installation/ai-apps/gemini-cli.md) |
+| Any MCP client | ✅ | ✅ | Server command: `npx -y @weppy/roblox-mcp` |
+
+## System Requirements
+
+| Requirement | Minimum |
+|-------------|---------|
+| Node.js | 18.0.0+ |
+| Roblox Studio | Latest (keep auto-updated) |
+| OS | Windows 10+ or macOS 12+ |
+| Network | localhost:3002 must be accessible |
+
+## Feature Matrix (Basic vs Pro)
+
+| Feature | Basic | Pro |
+|---------|:-----:|:---:|
+| MCP tool execution (scripts, instances, properties) | ✅ | ✅ |
+| Studio → Local one-way sync | ✅ | ✅ |
+| Bidirectional sync (Local → Studio) | ❌ | ✅ |
+| Per-type Direction and Apply Mode | ❌ | ✅ |
+| Sync history and changelog | ❌ | ✅ |
+| Multi-place support (up to 3 places) | ❌ | ✅ |
+| Bulk operations (mass_create, mass_set) | ❌ | ✅ |
+| Advanced spatial queries | ❌ | ✅ |
+| Terrain generation and fill | ❌ | ✅ |
+| Physics group management | ❌ | ✅ |
+| Tween and animation control | ❌ | ✅ |
+| Audio control | ❌ | ✅ |
+| Lighting and atmosphere | ❌ | ✅ |
+
+## MCP Tool Count
+
+21 consolidated tools with action-based sub-commands. See [Tools Reference](en/tools/overview.md) for the full list.

package/docs/en/sync/overview.md

@@ -110,6 +110,30 @@ When changes are detected on both Studio and local sides during bidirectional sy
 - Inspect target file with `read_file`
 - Restore content with `write_file`, then verify Studio state
 
+## File format (v2 nested directory)
+
+Each Roblox instance is stored as its own directory containing meta files:
+
+```
+explorer/
+├── Workspace/
+│   ├── _tree.json
+│   ├── Part/
+│   │   └── Part.props.json
+│   ├── MyScript/
+│   │   └── MyScript.server.luau
+│   └── Coins/
+│       └── Coins.value.json
+```
+
+Naming conventions:
+- Props: `{Name}/{Name}.props.json`
+- Scripts: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
+- Values: `{Name}/{Name}.value.json`
+
+Duplicate instance names use `~N` suffix on the directory (e.g. `Part~2/Part.props.json`).
+Names containing `~` are escaped to `~~` (e.g. `Part~2` becomes `Part~~2/`). The Odd-Count Tilde Rule applies: a trailing `~+N` is a collision suffix only when the tilde count is odd.
+
 ## Related docs
 
 - [Tools Overview](../tools/overview.md)

package/docs/es/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
-[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
+> Servidor MCP y plugin para Roblox Studio — controla scripts, terrain, assets e iluminacion con Claude Code, Cursor, Codex y Gemini.
 
-> Habla con la IA y se ejecuta directamente en Roblox Studio.
+[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## Instalacion rapida (5 minutos)
+
+**Paso 1** — Instala el plugin de Roblox Studio (puente entre Studio e IA):
+[Guia de instalacion del plugin](../en/installation/roblox-plugin.md)
+
+**Paso 2** — Registra el servidor MCP en tu app de IA:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| App de IA | Guia |
+|-----------|------|
+| Claude Code | [Configuracion](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [Configuracion](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [Configuracion](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [Configuracion](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [Configuracion](../en/installation/ai-apps/gemini-cli.md) |
+
+> Funciona con cualquier cliente MCP compatible. El comando del servidor es `npx -y @weppy/roblox-mcp`.
+
+## Compatibilidad
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**Requisitos:** Node.js 18+, Roblox Studio, Windows 10+ o macOS 12+
+
 ## Funciones principales
 
 ### 1) MCP Tool: ejecuta en Studio desde lenguaje natural
 
-El primer eje de Roblox MCP es la **ejecucion de MCP Tool**.
 La IA puede manejar directamente scripts, instancias, propiedades, terreno, iluminacion, assets, audio y animacion dentro de Studio.
 
 - "Agrega particulas + sonido + cooldown cuando el jugador salte."
@@ -21,7 +49,6 @@ No es solo generacion de codigo. Son **acciones ejecutables orientadas a producc
 
 ### 2) Sync: mantiene el contexto completo del proyecto
 
-El segundo eje es **Project Sync**.
 La IA trabaja sobre un espejo local sincronizado, asi que los cambios en multiples archivos se mantienen consistentes.
 
 ![Flujo de Sync — Studio y archivos locales sincronizados en tiempo real](../assets/screenshots/sync.png)
@@ -29,8 +56,6 @@ La IA trabaja sobre un espejo local sincronizado, asi que los cambios en multipl
 - Basic: sincronizacion unidireccional (Studio -> Local)
 - Pro: sincronizacion bidireccional + Direction/Apply Mode por tipo + historial + multiplace
 
-Asi mantienes claro cual es la fuente de verdad y no pierdes contexto de cambios.
-
 ## Valor inmediato para el usuario
 
 - Comprime trabajo repetitivo: convierte muchas ediciones manuales en una sola instruccion
@@ -40,25 +65,18 @@ Asi mantienes claro cual es la fuente de verdad y no pierdes contexto de cambios
 
 ## Documentacion detallada
 
-- [Cobertura de herramientas (Tools Overview)](tools/overview.md)
-- [Guia detallada de Sync](sync/overview.md)
-
-## Comenzar
-
-La instalacion se completa en dos pasos:
-
-1. **Instalar el plugin de Roblox Studio** — Hace de puente entre Studio e IA
-2. **Registrar el servidor MCP en tu app de IA** — Para que la app de IA lo reconozca
-
-Solo toma 5 minutos. 👉 [Ver guia de instalacion](installation/README.md)
+- [Guia de instalacion](../en/installation/README.md)
+- [Cobertura de herramientas](../en/tools/overview.md)
+- [Guia detallada de Sync](../en/sync/overview.md)
+- [Compatibilidad](../compatibility.md)
+- [Solucion de problemas](../troubleshooting.md)
 
 ## Upgrade Pro
 
 Sync bidireccional, capacidades de creacion avanzadas y eficiencia de tokens de IA — todo en una sola actualizacion.
 
-👉 [Guia de actualizacion Pro](pro-upgrade.md)
+[Guia de actualizacion Pro](../en/pro-upgrade.md)
 
-## Enlaces
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Reportar problemas](https://github.com/hope1026/roblox-mcp/issues)
+[GitHub Issues](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)