← Back

Connect BloxSmith to your AI

Use Claude Code, ChatGPT Codex, Google Antigravity, Cursor, or any other MCP-compatible client to build Roblox games inside your BloxSmith projects.

Want it the other way around? Connect your own MCP servers (Notion, Linear, GitHub, custom…) so the BloxSmith AI can use their tools while building.

Need help or want to share what you're building? Join the BloxSmith Discord.

How it works (3 steps)

  1. Generate your token below and copy it. Keep it secret — it spends your credits.
  2. Add BloxSmith as an MCP server in your AI client (Claude Code, Codex, Antigravity, VS Code, Cursor, Windsurf, or anything else that speaks MCP).
  3. Prompt your AI to call list_my_projects then build_roblox. That's it — your Studio plugin applies the changes.

Endpoint

https://bloxsmith.pro/api/public/mcp

Standard MCP Streamable HTTP transport — works with any MCP-compatible client. Authenticate with Authorization: Bearer <YOUR_MCP_TOKEN>. Generate, rotate, or revoke your personal token below — if it ever leaks, click Revoke to kill it instantly.

Your MCP API Key

Log in to generate, view, and revoke your personal MCP API key.

Pricing

Each build_roblox call costs 1 BloxSmith credit from the connected MCP user's account — the same as a build run from the website. Read-only tools (list_my_projects, list_project_files, read_project_file, search_roblox_toolbox) are free.

Claude.ai (web & desktop app)

In Claude, open Settings → Connectors → Add custom connector and fill in:

  • Name: BloxSmith
  • Remote MCP server URL: https://bloxsmith.pro/api/public/mcp

Click Add. Claude will open a BloxSmith authorization page — sign in (if you aren't already) and click Authorize. You'll be redirected back to Claude and BloxSmith tools will be available in any new chat.

No token needed — authorization is handled via OAuth. You can revoke access any time from Claude's connector settings.

Claude Code

Add to ~/.claude.json or run claude mcp add:

{
  "mcpServers": {
    "bloxsmith": {
      "type": "http",
      "url": "https://bloxsmith.pro/api/public/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

ChatGPT Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.bloxsmith]
type    = "http"
url     = "https://bloxsmith.pro/api/public/mcp"
headers = { Authorization = "Bearer YOUR_MCP_TOKEN" }

Google Antigravity

  1. Open Settings → MCP Servers → Add Server.
  2. Transport: Streamable HTTP.
  3. URL: https://bloxsmith.pro/api/public/mcp
  4. Add header Authorization = Bearer YOUR_MCP_TOKEN.

VS Code (GitHub Copilot Chat)

VS Code 1.99+ supports MCP servers in Copilot Chat agent mode. Create .vscode/mcp.json in your workspace (or add it to user settings):

{
  "servers": {
    "bloxsmith": {
      "type": "http",
      "url": "https://bloxsmith.pro/api/public/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Then open Copilot Chat → switch to Agent mode → click the tools icon and enable bloxsmith.

Cursor / Windsurf / Zed / Continue

Most editors use the same JSON shape. Add to their MCP settings file:

{
  "mcpServers": {
    "bloxsmith": {
      "url": "https://bloxsmith.pro/api/public/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}

Some IDE builds still expect a local stdio bridge instead of direct HTTP. If the direct URL does not connect, use this command-based server:

{
  "mcpServers": {
    "bloxsmith": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bloxsmith.pro/api/public/mcp",
        "--header",
        "Authorization: Bearer YOUR_MCP_TOKEN"
      ]
    }
  }
}

Any other MCP client

BloxSmith implements the standard MCP Streamable HTTP transport. If your client supports it, point it at the endpoint above with the Authorization header. To verify the connection from a terminal:

curl -X POST https://bloxsmith.pro/api/public/mcp \
  -H "Authorization: Bearer YOUR_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A successful response lists list_my_projects, build_roblox, and the other tools below.

Available tools

  • bloxsmith_chat — talk to the BloxSmith Roblox expert from inside your IDE. Ask Luau/Roblox questions, get code snippets, or get pointed at the right build tool. Free, no project needed.
  • list_my_projects — find a projectId. Free.
  • build_roblox — natural-language game building. Writes scripts and queues plugin actions for your Studio plugin to apply. 1 credit per call.
  • list_project_files / read_project_file — inspect existing code. Free.
  • search_roblox_toolbox — find free Roblox toolbox assets. Free.
  • search_roblox_docs — search official Roblox Creator Hub and Engine API docs. Free.
  • mcp_connection_help — get setup snippets for your IDE. Free.

Example prompt

Use bloxsmith. Call list_my_projects, then call build_roblox on the
top project with: "Add a sword combat system with M1/M2 attacks,
hit VFX, and a leaderboard for KOs."