Integrations
MCP Integration
Build Roblox games from Claude Code, Cursor, Windsurf, or any MCP-compatible editor — without leaving your workflow.
Overview
The ForjeGames MCP server lets you generate Roblox builds, scripts, and game systems directly from any editor that supports the Model Context Protocol (MCP). Instead of switching to the ForjeGames web editor, you stay in your code editor and let the AI call ForjeGames tools on your behalf.
Supported editors
Any editor or client that supports MCP works with ForjeGames. The most popular:
- Claude Code — Anthropic's CLI for Claude. Config lives in
.claude/settings.json. - Cursor — AI-native code editor. Config lives in
.cursor/mcp.json. - Windsurf — Codeium's AI editor. Config lives in
.windsurf/mcp.json. - Any MCP client — anything that speaks the MCP protocol can connect.
Setup
Three steps and you're building:
- Create an API key — Go to Settings → API Keys and generate a new key. Copy it immediately — it's only shown once.
- Add the MCP config to your editor — Paste the config snippet below into the right file for your editor.
- Start building — Ask your AI assistant to build something in Roblox. It will call the ForjeGames tools automatically.
Claude Code config
Add this to your .claude/settings.json (or the global settings at ~/.claude/settings.json):
{
"mcpServers": {
"forjegames": {
"command": "npx",
"args": ["-y", "@forjegames/mcp-server"],
"env": {
"FORJE_API_KEY": "fg_sk_your_api_key_here"
}
}
}
}Cursor config
Add this to .cursor/mcp.json in your project root:
{
"mcpServers": {
"forjegames": {
"command": "npx",
"args": ["-y", "@forjegames/mcp-server"],
"env": {
"FORJE_API_KEY": "fg_sk_your_api_key_here"
}
}
}
}Windsurf config
Add this to .windsurf/mcp.json in your project root:
{
"mcpServers": {
"forjegames": {
"command": "npx",
"args": ["-y", "@forjegames/mcp-server"],
"env": {
"FORJE_API_KEY": "fg_sk_your_api_key_here"
}
}
}
}Available tools
Once connected, your AI assistant can call these tools. You don't need to remember the tool names — just describe what you want and the AI picks the right one.
| Tool | Description |
|---|---|
forje_build | Generate a Roblox map or structure from a text description. Returns Luau code with parts, terrain, and lighting. |
forje_script | Generate a Luau game script — leaderboards, shops, combat systems, NPCs, UI handlers, DataStore logic, and more. |
forje_template | Generate a full game from a template — obby, tycoon, simulator, RPG, horror, battle royale, and more. |
forje_status | Check your account status — remaining tokens, current plan, and usage for the billing period. |
forje_templates_list | List all available game templates with descriptions, so you can pick one before calling forje_template. |
Example usage
Once the MCP server is connected, just talk to your AI assistant naturally. Here are some things you can say:
The AI will call the appropriate ForjeGames tool, generate the output, and return the Luau code directly in your editor. From there you can copy it into Roblox Studio or pipe it through the Studio Plugin for live sync.
Troubleshooting
Common issues:
- "Tool not found" or "MCP server not connected" — Make sure the config file is in the correct location for your editor and restart the editor after adding it.
- "Invalid API key" — Double-check you copied the full key starting with
fg_sk_. Keys are shown only once when created. - "Rate limit exceeded" — You've hit your plan's daily limit. Upgrade your plan or wait for the reset.
- npx hangs or fails — Make sure Node.js 18+ is installed and
npxis on your PATH. - Editor doesn't show ForjeGames tools — Some editors require you to enable MCP in their settings. Check your editor's MCP documentation.
Still stuck? Check the full troubleshooting guide or ask in Discord.