# Arrival.Space

> Arrival.Space hosts shareable 3D spaces that open in any browser: Gaussian splats (photoreal 3D scans), 3D models, images, video, portals ("gates") between spaces, and JavaScript plugins, with multiplayer, avatars and voice chat built in. Visitors need no install; desktop, mobile and VR headsets all work. A space lives at https://arrival.space/<spaceId>.

Good fit: turning a 3D scan or a set of models into a place people can walk through and share by link - virtual showrooms, property or venue tours, exhibitions and galleries, event spaces, interactive 3D experiences and small multiplayer games.

## Start here (for AI agents)

- [Agent guide](https://arrival.space/agents.md): which interface to use, CLI setup and login, the edit/validate/push workflow, and the rules plugins must follow. Public, no login needed. The same file is written as AGENTS.md into every workspace `arrival pull` creates.

## Interfaces

- [MCP server](https://codex.arrival.space/api/mcp-server): `https://api-live.arrival.space/api/v1/mcp` (Streamable HTTP, OAuth sign-in with an Arrival.Space account). Best for a chat assistant making a few changes: create a space, upload a file, place and adjust entities, take a screenshot.
- [Arrival CLI](https://codex.arrival.space/api/cli): `arrival` - pull a space into local files (room.json, entities/*.json, plugins/*.mjs, assets/*), edit with any editor and git, `arrival validate`, `arrival push`. Best for writing plugins or changing many things at once. Run `arrival guide` for the agent guide.
- [REST API](https://codex.arrival.space/api/file-upload-api): base `https://api-live.arrival.space/api/v1`, Bearer API key or OAuth 2.0 + PKCE. Uploads, processing jobs, spaces, entities, gates, privacy.

## Plugins (JavaScript in a space)

- [Plugin SDK, docs and examples](https://github.com/arrival-space/arrival-plugins): `ArrivalScript` classes, the `ArrivalSpace.*` API, multiplayer sync, 40+ example plugins, TypeScript types, and the CLI source (tools/arrival-cli).
- [Agent quickstart](https://github.com/arrival-space/arrival-plugins/blob/main/docs/00-agent-quickstart.md): the hard rules generated plugins most often get wrong. Read before writing a plugin.
- [API reference](https://github.com/arrival-space/arrival-plugins/blob/main/docs/api-reference.md)

## User manual

- [Manual index (llms.txt)](https://codex.arrival.space/llms.txt): spaces, editing, gates, 3D content and splat formats, avatars, sharing, FAQ.