Model Context Protocol

Let an agent build the scene.

The package ships an MCP server. Point Claude, ChatGPT, Cursor or your own agent at it and it can generate 3D models, compose an arrangement, and hand a person one link that opens that arrangement in their actual room.

Install

{
  "mcpServers": {
    "3d-ar-studio": {
      "command": "npx",
      "args": ["-y", "3d-ar-studio-mcp"]
    }
  }
}

No API key. Every tool below is free and keyless.

Tools

Tool	What it does
`generate_3d_model`	Turn a text prompt into a downloadable, textured GLB. Returns the model URL plus links that open it in AR.
`check_generation`	Collect a generation that was still rendering when the first call returned.
`search_models`	Search the free CC0 library (or any catalogue you configure) by name, category and tag.
`compose_ar_scene`	Arrange several models into one scene and return a single link (and a QR-friendly short form) that reopens it exactly.
`export_ar`	Turn any GLB URL into a device-aware "View in your space" link: Quick Look on iOS, Scene Viewer on Android, WebGL on desktop.
`create_ar_page`	Emit a complete, self-contained HTML page that embeds the studio, configured for the caller's models: ready to commit and publish.

What a session looks like

> Put a mid-century lamp and a potted fern in my living room.

  generate_3d_model  { prompt: "a brass mid-century desk lamp" }   → lamp.glb
  search_models      { query: "potted plant" }                     → fern.glb
  compose_ar_scene   { models: [{ src: lamp.glb, x: 0,   z: -1.4 },
                                { src: fern.glb, x: 0.9, z: -1.2 }] }

  → https://your-page.example/ar/#s=… (open it on a phone; both objects
    stand in the room, exactly where they were arranged)

Configuration

Environment variable	Default	What it changes
`AR_STUDIO_PAGE_URL`	the hosted demo	The page `compose_ar_scene` links to. Set it to your own deployment.
`AR_STUDIO_ASSETS`	the free CC0 library	Catalogue URL `search_models` searches.
`AR_STUDIO_MCP_ENDPOINT`	three.ws 3D Studio	The MCP endpoint used for generation.
`AR_STUDIO_ORIGIN`	`https://three.ws`	Origin for the hosted "View in your space" launcher and viewer links.

See what it builds Full MCP docs