Weppy Roblox MCP WEPPY

WEPPY

Codex CLI Setup

How to use the WEPPY AI Agent Plugin and the WEPPY MCP Server from WEPPY Roblox AI Toolkit with Codex CLI.

How to use the WEPPY AI Agent Plugin and the WEPPY MCP Server from WEPPY Roblox AI Toolkit with OpenAI Codex CLI (terminal-based AI coding tool).

Codex plugins can bundle skills, app integrations, and MCP server settings. WEPPY ships as a Codex plugin with the MCP server config and Roblox Studio workflow skills, so installing the plugin first is recommended over manual MCP setup.

Prerequisites

  • Node.js (v18.0.0 or higher)
  • Codex CLI installed
  • WEPPY Roblox Studio Plugin installation complete

Install Codex CLI

npm install -g @openai/codex

If it is already installed, update it to the latest version:

codex update

Add the WEPPY AI Agent Plugin marketplace from your terminal:

codex plugin marketplace add hope1026/weppy-roblox-mcp

Then reopen Codex CLI and open the plugin list:

codex
/plugins

Select WEPPY AI Agent Plugin from the added WEPPY marketplace and run Install plugin.

After installation, start a new conversation. The plugin adds the npx -y @weppy/roblox-mcp@latest MCP server config together with WEPPY skills. If needed, use @ in a prompt to target a plugin or bundled skill, or use /skills or $ to find and invoke installed skills.

Method 2: Register the WEPPY MCP Server Manually

Use this only if you want the MCP server without WEPPY skills. If you installed the plugin with Method 1, you can skip this step.

CLI Command

codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp@latest

Edit Config File Directly

Add the following to your ~/.codex/config.toml file:

[mcp_servers.weppy-roblox-mcp]
command = "npx"
args = ["-y", "@weppy/roblox-mcp@latest"]

Config file location:

OSPath
macOS/Linux~/.codex/config.toml
Windows%USERPROFILE%\.codex\config.toml

Connection Test

  1. Launch Roblox Studio → Plugins tab → WEPPY → Connect
  2. Run Codex CLI and enter: 
    Tell me what is currently selected in Roblox Studio

Troubleshooting

Server Won’t Start

Run the MCP server directly to see the error:

npx -y @weppy/roblox-mcp@latest

WEPPY AI Agent Plugin Does Not Appear in the List

Refresh the marketplace, then restart Codex:

codex plugin marketplace upgrade hope1026-roblox-mcp

Connection Fails

  • Confirm the WEPPY Roblox Studio Plugin shows Connected status
  • Check that port 3002 is not blocked by a firewall