# Mudroom

> Self-hosted, open-source server that lets AI agents book with a business.

These files are the product documentation. A running Mudroom server serves a different /llms.txt: the live booking instructions for that business, including its services and prices.

## Start

- [What Mudroom is](/docs/overview.md): One server per business that lets an AI agent find a time, ask a question, and book.
- [Install](/docs/install.md): Install Mudroom with the script or by hand, then run the setup wizard.

## Booking

- [Choose a booking system](/docs/booking-system.md): Pick Google Calendar, Square, or the GlossGenius experiment. Slack and SMS sit beside any of them.
- [Google Calendar](/docs/google.md): Share a calendar with a service account. Mudroom builds the slots and prices.
- [Square Appointments](/docs/square.md): Square owns the services, prices, and slots. Mudroom books as a buyer, not as the seller.
- [GlossGenius](/docs/glossgenius.md): Experimental. Mudroom reads the public booking page and writes the appointment to a Google Calendar you copy into GlossGenius.

## Owner

- [Slack](/docs/slack.md): Experimental. Agent questions land in a channel, and you answer by typing in the thread. No public URL.
- [Text messages](/docs/twilio.md): Experimental. Questions and booking notices arrive by SMS. Contact the customer directly; replies are not read.

## Run

- [Go live](/docs/deploy.md): One process, one SQLite file, and a public HTTPS address. Docker, a tunnel, or a platform.

## Reference

- [Configuration](/docs/configuration.md): Every config.json field and every environment variable, including defaults.
- [Errors](/docs/errors.md): One error body, and every code, status, and whether the agent should retry.

## Agents

- [How agents book](/docs/agents.md): Give the agent your Mudroom server's URL. It reads /llms.txt on that host and books over HTTP.

## Contributing

- [How it fits together](/docs/architecture.md): One process, SQLite, and three connector contracts. Agents speak HTTP, not MCP.
- [Add a connector](/docs/connectors.md): The registry, and the checklist a pull request has to meet before a connector is done.