Handles hosting payments through Stripe Checkout, including creating checkout sessions for spaces that require payment and waiting for payment completion.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Spacery MCP server publish ./scans/observatory.e57 as a space"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Spacery hosts 3D captures as virtual spaces with guided tours, shared with a link. This repository holds the Spacery connector (an MCP server) and agent skill, so your agent can publish captures for you and build tours and scavenger hunts in them.
Publish E57 and other laser scans, Matterport exports, 3D Gaussian splats, 360 photos and video, meshes and photo sets as spaces, straight from your computer.
Build guided tours and scavenger hunts in your own spaces or Spacery's public ones (museums, temples, tombs, gardens). Spacery's tour agent writes the stops and places 3D models, effects, sound, looks (line drawing, blueprint, film noir, night vision) and skies (a sunset, a storm, the Milky Way).
Your account links through a code you approve in your browser. Payment goes through Stripe Checkout in your browser. The connector never sees a password or a card.
Live demos: an observatory from a Matterport E57 and a garden as 3D Gaussian splats. Free to try. Hosting from $5 a month (pricing).
Local connector | Hosted connector | |
Runs | on your computer, over stdio | on Spacery, over Streamable HTTP |
Address |
|
|
Reads files on your computer | yes, and uploads them in the background with resume | no, it takes files the agent holds and gives you a page to drop the rest on |
Use it in | Claude Code, Claude Desktop, Codex, Grok Build, Antigravity, Gemini CLI, Cursor | claude.ai, ChatGPT, grok.com, Meta Muse and other apps that take a connector URL |
The local connector is one readable JavaScript file with no dependencies. It needs Node.js 18 or later.
Related MCP server: maige-3d-mcp
Claude Code, as a plugin with the connector and the skill.
claude plugin marketplace add lukehollis/spacery
claude plugin install spacery@spaceryOr the connector alone.
claude mcp add --scope user spacery -- npx -y https://spacery.dev/agents/spacery-0.2.2.tgzClaude Desktop. Download spacery.mcpb and open it.
Codex.
codex mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.2.tgzGemini CLI.
gemini extensions install https://github.com/lukehollis/spaceryGrok Build.
grok mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.2.tgzAntigravity.
agy mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.2.tgzCursor and any other agent that reads an mcpServers config.
{
"mcpServers": {
"spacery": { "command": "npx", "args": ["-y", "https://spacery.dev/agents/spacery-0.2.2.tgz"] }
}
}claude.ai, ChatGPT, grok.com, Meta Muse and other apps in the cloud. Add a custom connector with the URL
https://app.spacery.dev/mcp.
skills/spacery/SKILL.md teaches an agent the publishing and tour steps. Add it with
npx skills add lukehollis/spaceryor save it as spacery/SKILL.md in your agent's skills folder (~/.claude/skills, ~/.agents/skills
for Codex, ~/.grok/skills, ~/.gemini/config/skills for Antigravity).
Tool | What it does |
| Looks at capture files and folders on this computer (local connector) |
| Links the agent to your Spacery account through a code you approve in the browser |
| Shows the ways to pay for hosting |
| Creates a space and opens Stripe Checkout when hosting needs payment |
| Waits for Checkout to finish |
| Uploads a capture in the background and submits it for processing |
| Submits files the agent uploaded itself (hosted connector) |
| Shows upload and processing progress |
| Makes a ready space public or private |
| Finds your spaces and public spaces to build a tour or scavenger hunt on |
| Starts a guided tour or scavenger hunt on a space |
| Asks Spacery's tour agent to write the tour, with models, effects, sound, looks and skies |
| Waits for a draft and summarizes the tour |
| Shows a tour with everything it can use, and saves one edited by hand |
| Searches the library of ready-made 3D models |
| Adds your own |
| Lists your tours, and shares one by link or makes it private again |
| Unlinks the agent |
Ask your agent
"Publish the scan in ~/Captures/studio as a Spacery space."
"Make a scavenger hunt for five artifacts in a Spacery museum, ending in a line drawing."
"Model a bronze lantern in Blender and put it by the altar in my temple tour."
Setup for agents: spacery.dev/agents.md
The open source viewer behind Spacery, which you can host yourself: lukehollis/sphr
MIT licensed.
This server cannot be deployed
Build a real 3D website by chatting: pages, models and text in space, published to a live URL.
Build 3D web apps: physics, audio, music, Blender import. Live edits, undo, versions, publishing.
Enhance, virtually stage and turn real estate listing photos into video with AI.
Turn product photos into true-scale 3D models and AR pages, then publish, embed and catalog them.
