# Mapshroom

> Mapshroom is a browser projection-mapping workspace. Its public MCP server lets AI assistants read product/workflow context and the GLSL contract, prepare shader previews, and return import links. It is independent of any user's computer.

## MCP

- [MCP setup guide](https://mapshroom.dev/mcp/): remote and local setup, client configuration, troubleshooting.
- [Guida MCP in italiano](https://mapshroom.dev/it/mcp/): configurazione e istruzioni per agenti.
- [Agent instructions](https://mapshroom.dev/mcp/agents.md): exact endpoint, tools, validation and setup workflow.
- [Product and workflow context](https://mapshroom.dev/mcp/context.md): versioned photo → depth → shader guide, input semantics, limitations and runnable examples; also available as get_mapshroom_context.
- [Depth demonstration](https://mapshroom.dev/ai/?example=depth-contours): synthetic depth contours with adjustable controls.
- [Demo depth image](https://mapshroom.dev/mcp/demo-depth.png): the matching grayscale input to load in the workspace.
- [Cursor configuration](https://mapshroom.dev/mcp/client-config.json): merge into existing mcp.json.
- Remote endpoint: https://mapshroom.dev/api/mcp (Streamable HTTP; no authentication).
- Local STDIO download: https://mapshroom.dev/ai/mapshroom-mcp.mjs (Node.js 22+; optional).

Reading this index does not install the server. Add and enable it in your MCP client. The remote server has no workspace pairing or project synchronization. AI client and in-chat preview support vary. Search crawling does not automatically register a tool with an assistant.

## Guides

- [Tutorial](https://mapshroom.dev/tutorial/): photo, depth, mapping, projector and shader workflow.
- [Shader guide](https://mapshroom.dev/shader/): describe and refine visual effects.
- [About](https://mapshroom.dev/about/): application overview.
- [Privacy](https://mapshroom.dev/privacy/): local projects and optional services.