Homemade
dev.homemade/homemade · v1.0.1 · MCP 2025-11-25
Create, run and manage Homemade dev VMs and projects from your AI agent.
Reachability
reachable
checked 2026-11-21 05:31 UTC
Registry status active
Tools pinned 38
01e937cc102f
Tools last changed
unchanged since first capture 2026-11-21
Repo last push 2026-11-17
as of 2026-11-21
GitHub stars 0
as of 2026-11-21
Provenance
Registry namespace dev.homemade
(domain verified by the official registry)
Repository
github.com/usehomemade/homemade
Website
https://www.homemade.dev
Remote endpoints
https://api.homemade.dev/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:31 | first capture | 38 tools pinned |
Pinned tool definitions (38)
| Tool | Description |
|---|---|
| api_key_delete | Delete an API key. Revokes the key at once. Requests that use it get 401 from then on. |
| api_key_list | List API keys. Your API keys. The secret itself is shown only once, when the key is created. |
| api_key_rename | Rename an API key |
| chat_delete | End an agent chat |
| chat_list | List agent chats |
| chat_new | Start an agent chat. Starts a chat in the VM. A VM keeps at most one empty chat: when it already has one, you get that. |
| chat_send | Send a message to an agent. Sends a prompt to a coding agent in the VM, in a new chat or the one named by `sessionId`. It answers at once; follow the chat in the dashboard or with the CLI. |
| config_validate | Validate a project config. Checks a `.homemade/config.json` or `.jsonc` file against the config schema. `.ts` and `.js` configs are checked at the first build instead. |
| project_branches | List branches. The branches a VM of this project can boot, the default branch first. |
| project_create | Create a project. Creates a project from a GitHub repository your team connected (`repo` as owner/name, or `githubInstallationId` + `githubRepoId`), from a starter (`template`), or empty. A new project starts its first VM on its own;... |
| project_delete | Delete a project. Deletes the project and every VM in it. This cannot be undone. |
| project_get | Get a project |
| project_list | List projects. Every project in your teams, newest first. Pass `orgId` for one team's projects. |
| project_update | Update project settings. Changes the project's slug, default branch, default auto-sleep and other settings. Every field is optional. |
| sandbox_create | Create a sandbox. Creates a sandbox: a throwaway VM with no project, on the plain base image or on one of your projects' images. It answers at once while the sandbox starts; a command sent to it waits until it is up. It never sleeps and... |
| sandbox_delete | Delete a sandbox. Deletes the sandbox and everything in it. This cannot be undone. |
| sandbox_exec | Run a command in a sandbox. Runs one command in the sandbox with `/bin/sh -lc` and answers its exit code and output. A sandbox that is still starting is waited for (up to a minute). The sandbox's own `env` is set, under the command's.... |
| sandbox_extend | Extend a sandbox. Sets how long the sandbox lives from now: `ttlMinutes`, at most 1440 (24 hours). |
| sandbox_get | Get a sandbox. One sandbox: its state, size and when it is deleted. |
| sandbox_list | List sandboxes. Every sandbox in your teams that is not deleted, oldest first. |
| sandbox_read_file | Read a file. Reads a file from the sandbox as text, or as base64 with `encoding=base64`. At most 10 MB. |
| sandbox_write_file | Write a file. Writes a file in the sandbox (text, or base64 for bytes), making its folders. Replaces a file already there. At most 10 MB. |
| setup_report | Report setup progress. For coding agents running the setup at `/get-started.md`: tells the person's dashboard how far you got. Call it with `connected` right after signing in, `project` once the project exists, `checking` when Project... |
| shell_delete | End a terminal session |
| shell_list | List terminal sessions. The VM's open terminals. Each one keeps running when nobody is attached. |
| ssh_key_add | Add an SSH key. Adds an SSH public key. Running VMs in your teams accept it within seconds. |
| ssh_key_delete | Remove an SSH key |
| ssh_key_list | List SSH keys |
| vm_create | Create a VM. Creates a VM from a project's latest build and starts it. The answer comes at once with the VM in `queued` or `booting`; poll `GET /api/vms/{vmId}` until `state` is `running`. |
| vm_delete | Delete a VM. Deletes the VM and its data. This cannot be undone. |
| vm_dismiss_signal | Dismiss the agent signal. Clears the attention signal an agent in the VM raised. Does nothing when there is none. |
| vm_exec | Run a command. Runs one command in a running VM as its user, with `/bin/sh -lc`, and answers its exit code and output. It opens no terminal. Use `?stream=1` for commands that run longer than about 90 seconds. |
| vm_get | Get a VM. The VM, its project, its services and its newest events. `vm.urls` holds each service's public URL by port. |
| vm_list | List VMs. Every VM in your teams that is not deleted, newest first. Pass `projectId` to list one project's VMs. |
| vm_sleep | Sleep a VM. Puts a running VM to sleep. It keeps its memory and disk and wakes where it left off. Sleeping an asleep VM answers 200. |
| vm_update | Update a VM. Renames the VM, changes its auto-sleep or who can open its services. Every field is optional. |
| vm_wake | Wake a VM. Wakes an asleep VM. Poll `GET /api/vms/{vmId}` until `state` is `running`. |
| whoami | Get the current user. The key's owner and the teams it can reach. A team's `id` is the `orgId` other calls take. |
Get alerted when this changes.
Email the moment dev.homemade/homemade drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/dev.homemade/homemade)
Maintain this server? Add the badge to your README. It links your users to this live status page.