Spacery

io.github.lukehollisPublished by GitHub account lukehollisv0.2.3Updated Oct 24, 2026

Publish 3D scans, Gaussian splats and 360 tours as shareable spaces, and build guided tours in them

VerifiedStreamable HTTPWeb executableMedia & Design

Overview

Spacery's hosted MCP server (app.spacery.dev); no sign-in required; Streamable HTTP; 18 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
app.spacery.dev
Last checked

Installation

In SourceWeft

  1. Open Spacery in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.lukehollis%2Fspacery/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "spacery": {
      "type": "http",
      "url": "https://app.spacery.dev/mcp"
    }
  }
}

README

[Spacery]

Spacery MCP server and agent skill

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).

Two connectors

Local connectorHosted connector
Runson your computer, over stdioon Spacery, over Streamable HTTP
Addressnpx -y https://spacery.dev/agents/spacery-0.2.3.tgzhttps://app.spacery.dev/mcp
Reads files on your computeryes, and uploads them in the background with resumeno, it takes files the agent holds and gives you a page to drop the rest on
Use it inClaude Code, Claude Desktop, Codex, Grok Build, Antigravity, Gemini CLI, Cursorclaude.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.

Add it

Claude Code, as a plugin with the connector and the skill.

bash
claude plugin marketplace add lukehollis/spaceryclaude plugin install spacery@spacery

Or the connector alone.

bash
claude mcp add --scope user spacery -- npx -y https://spacery.dev/agents/spacery-0.2.3.tgz

Claude Desktop. Download spacery.mcpb and open it.

Codex.

bash
codex mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.3.tgz

Gemini CLI.

bash
gemini extensions install https://github.com/lukehollis/spacery

Grok Build.

bash
grok mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.3.tgz

Antigravity.

bash
agy mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.3.tgz

Cursor and any other agent that reads an mcpServers config.

json
{  "mcpServers": {    "spacery": { "command": "npx", "args": ["-y", "https://spacery.dev/agents/spacery-0.2.3.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.

The skill

skills/spacery/SKILL.md teaches an agent the publishing and tour steps. Add it with

bash
npx skills add lukehollis/spacery

or 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).

Tools

ToolWhat it does
check_filesLooks at capture files and folders on this computer (local connector)
link_accountLinks the agent to your Spacery account through a code you approve in the browser
list_plansShows the ways to pay for hosting
create_spaceCreates a space and opens Stripe Checkout when hosting needs payment
wait_for_paymentWaits for Checkout to finish
upload_filesUploads a capture in the background and submits it for processing
finish_uploadSubmits files the agent uploaded itself (hosted connector)
space_statusShows upload and processing progress
set_visibilityMakes a ready space public or private
find_tour_spacesFinds your spaces and public spaces to build a tour or scavenger hunt on
create_tourStarts a guided tour or scavenger hunt on a space
draft_tourAsks Spacery's tour agent to write the tour, with models, effects, sound, looks and skies
wait_for_tourWaits for a draft and summarizes the tour
get_tour, save_tourShows a tour with everything it can use, and saves one edited by hand
search_modelsSearches the library of ready-made 3D models
upload_model, upload_skyAdds your own .glb model or 360 sky image to a tour (local connector)
list_tours, share_tourLists your tours, and shares one by link or makes it private again
unlink_accountUnlinks the agent

Try it

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."

More

MIT licensed.

Source: README.md at commit 40a7306

Tools

18

list_plans

List hosting plans

The ways to pay for hosting, with prices, and the account's current plan. The first space is a free private preview, so show them when the person wants to publish it or keep it.

Takes no parameters.

create_space

Create space

Creates a space for one capture. An account that does not pay for hosting yet gets its first space as a free private preview: upload and process it with no payment. After that, it returns a Stripe Checkout link for the plan the person chose (pay as you go when none is given) for them to pay; then call wait_for_payment. Never ask for card details.

Parametersplantitlerequired

wait_for_payment

Wait for payment

Waits up to 25 seconds for the person to finish paying in Stripe Checkout, whether for a space's first payment or to publish a free preview. Call it again to keep waiting.

Parametersspace_idrequired

upload_files

Upload files

Starts resumable uploads for capture files you hold (for example photos or video the person shared with you) and returns where to PUT each file's bytes. For files on the person's own device, give them the space's page to drop the files instead.

Parametersfilesrequiredspace_idrequired

finish_upload

Finish upload

Checks that every uploaded file is complete and submits the space for processing. The account is emailed when the space is ready.

Parametersnotesoutputsubmitspace_idrequired

space_status

Space status

Status of one space, or every space on the account with its link when ready.

Parametersspace_id

set_visibility

Set space visibility

Makes a ready space public (anyone with the link) or private (only the owner). Ask the person first. A free preview cannot be public until hosting starts, so it returns a Stripe Checkout link for the person to pay.

Parameterspublicrequiredspace_idrequired

find_tour_spaces

Find spaces for tours

Spaces a guided tour or scavenger hunt can be built on: the person's own finished spaces and the site's public spaces (museums, temples, tombs, gardens). Search by words in the title.

Parametersquery

list_tours

List tours

The tours and scavenger hunts on the account, with their links.

Takes no parameters.

create_tour

Create tour

Starts a private guided tour or scavenger hunt on a space from find_tour_spaces; fill it with draft_tour or save_tour.

Parameterskindtitlescene_idrequired

draft_tour

Draft tour

Asks the site's tour agent, which sees the space's photographs, to write or rework the tour from a plain request: stops and text, hidden objects and clues, library models, effects, sound, music, looks with transitions and skies (day, sunset, storm, night, stars). It places everything and saves. Returns at once; then call wait_for_tour.

Parametersrequestrequiredtour_idrequired

wait_for_tour

Wait for tour draft

Waits up to 25 seconds for a draft to finish, then summarizes the tour. Call it again to keep waiting.

Parameterstour_idrequired

get_tour

Get tour

The tour as JSON (stops, objects, effects, looks, skies) with its revision, for editing with save_tour.

Parameterstour_idrequired

save_tour

Save tour

Saves a tour edited by hand: the experience JSON from get_tour with changes. Models use a url from search_models, or any https address of a .glb.

Parameterstitletour_idrequiredexperiencerequired

search_models

Search 3D models

Searches the library of ready-made 3D models (statues, amphorae, temples, furniture, animals, props from many periods). Returns each model's size and url.

Parameterslimitqueryrequired

share_tour

Share tour

Makes a tour public (anyone with its link, never listed) or private, and optionally renames it. Ask the person first.

Parameterstitlepublictour_idrequired

Version history

2
  1. v0.2.3LatestOct 20, 2026
  2. v0.2.2Oct 20, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts