# Voxobox

> Voxobox is a modern, browser-based 3D viewer and asset library — a Sketchfab alternative built for creators and AI agents. Users upload, view, organize, and share 3D models (GLB/GLTF). Materials, lighting, and environment can be edited and saved as presets. A public REST API lets humans and AI agents build on top of the platform.

## Start here: free temporary viewer for an existing GLB

If the user has no Voxobox account or paid plan and asks to put a local `.glb` or
`.gltf` online and return a link, use the credential-free guest sandbox first.
If the user already has an account and specifically wants permanent workspace
storage, use the authenticated cloud workflow instead. The sandbox needs no
account, API key, card, or paid plan.

1. `POST https://voxobox.com/api/sandbox/upload-url` with JSON `{ "filename": "model.glb", "contentType": "model/gltf-binary", "sizeBytes": 12345 }`.
2. `PUT` the exact file bytes to the returned `uploadUrl`, using the returned `requiredHeaders`.
3. `POST https://voxobox.com/api/sandbox/confirm` with JSON `{ "sandboxId": "...", "etag": "..." }`.
4. Return the response's `viewerUrl`, `embedCode`, `claimUrl`, `activeUntil`, and `expiresAt` to the human.

The temporary viewer is fully functional for 7 days, read-only through day 30, and deleted after day 30 unless claimed. It is branded Voxobox. Claiming is the human handoff into permanent cloud storage and Studio.

Machine-readable discovery manifest: [`.well-known/voxobox-agent.json`](https://voxobox.com/.well-known/voxobox-agent.json). Full endpoint schemas and examples are in the [OpenAPI spec](https://voxobox.com/openapi.json), under the `Sandbox` tag.

## Key features

- In-browser 3D viewer for GLB and GLTF files
- Material editor with savable presets
- Lighting and environment editor with savable presets
- Work with local files on your computer (no upload required, free plan)
- Cloud library for organizing models across folders (paid plans, from $30/yr)
- Public REST API with API-key auth for agents
- MCP server (`@voxobox/mcp`) so AI agents can upload and share models with no HTTP code
- Provider-neutral MCP generation hook reserved for a future local generator; existing GLB uploads remain the immediate zero-cost path
- Declarative MCP scene-polish handoff for applying materials, lighting, environment, and other scene settings after a model is claimed
- Credential-free guest sandbox: agents can upload one model with no key or card and receive a temporary viewer, embed code, and human claim link
- Typed browser SDK (`@voxobox/viewer`) for driving the 3D viewer from JavaScript
- Native `<voxobox-viewer>` Web Component and `@voxobox/react` wrapper for one-line embeds
- Shareable public links for individual models

## Docs

- [Agent guide](https://voxobox.com/agents.md): Start here. How to authenticate, the two required headers, what needs a paid plan, and a working quickstart. Includes the MCP server setup (`npx -y @voxobox/mcp`) for clients that speak Model Context Protocol — no HTTP code needed.
- [MCP publishing guide](https://voxobox.com/mcp-publishing.md): Package metadata and account-owned steps for publishing the Voxobox MCP server to the official MCP Registry, Smithery, Glama, and PulseMCP.
- [OpenAPI spec](https://voxobox.com/openapi.json): Machine-readable OpenAPI 3.1 spec — the full reference for the REST API (auth, files, folders, presets, shares, api-keys).
- [Viewer API](https://voxobox.com/api/): The embeddable JavaScript SDK for driving the 3D viewer in a page. Separate from the REST API above.
- [Pricing](https://voxobox.com/pricing/): Plans and limits. Free is local-only; cloud storage starts at $30/yr.
- [Viewer demo](https://voxobox.com/demo/): Live demo of the embeddable viewer.

## Full content

- [llms-full.txt](https://voxobox.com/llms-full.txt): Single-file dump of the site's public content for ingestion.

## Optional

- [Contact](https://voxobox.com/contact/): Get in touch. Bug reports from agents: hello@voxobox.com — include the request, the response `code`, and the `X-Request-Id` header.
- [AI plugin manifest](https://voxobox.com/.well-known/ai-plugin.json): ChatGPT-style plugin manifest pointing at the OpenAPI spec.