Homemade
● Activedev.homemade/homemade
Create, run and manage Homemade dev VMs and projects from your AI agent.
Connect this server
One click to install, or copy the config below. Suits: Cursor · HTTP clients.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"homemade": {
"url": "https://api.homemade.dev/mcp"
}
}
}claude mcp add --transport http homemade https://api.homemade.dev/mcpcode --add-mcp '{"name":"homemade","type":"http","url":"https://api.homemade.dev/mcp"}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Developer Tools
- Version
- 1.0.1
- Registry
- active
- Published
- 11/20/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Mostly fine: Homemade is maintained, hosted endpoint answering without a key.
- Maintained
- Active
- Last commit 5 days ago (Nov 17, 2026), 0 open issues.
- Official registry
- Active
- Published as dev.homemade/homemade in the official MCP registry, version 1.0.1.
- Source
- No licence found
- Public repository, but GitHub reports no recognised licence (0 stars). Check the README before shipping it in a product.
- Runs
- Hosted by the publisher
- Your client talks to api.homemade.dev: prompts and tool arguments leave your machine for that host.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 07:08 UTCStatus history & uptime →The endpoint answered the MCP handshake as "Homemade" and listed 38 tools. Answering since Nov 21, 2026.
Context cost ≈ 7.5k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 38 tools.
Tools (38)
api_key_delete1 paramDelete an API key. Revokes the key at once. Requests that use it get 401 from then on.
Show parametersHide parameters
keyIdstringrequired
api_key_listList API keys. Your API keys. The secret itself is shown only once, when the key is created.
api_key_rename2 paramsRename an API key
Show parametersHide parameters
keyIdstringrequirednamestringrequired
chat_delete2 paramsEnd an agent chat
Show parametersHide parameters
vmIdstringrequiredsessionIdstringrequired
chat_list1 paramList agent chats
Show parametersHide parameters
vmIdstringrequired
chat_new1 paramStart 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.
Show parametersHide parameters
vmIdstringrequired
chat_send5 paramsSend 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.
Show parametersHide parameters
vmIdstringrequiredmessagestringrequiredmodelstringpermissionModestringsessionIdstring
config_validate2 paramsValidate 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.
Show parametersHide parameters
contentstringrequiredpathstringrequired
project_branches1 paramList branches. The branches a VM of this project can boot, the default branch first.
Show parametersHide parameters
projectIdstringrequired
project_create10 paramsCreate 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; `welcomeVm` says how that went.
Show parametersHide parameters
configobjectdefaultBranchstringgithubInstallationIdintegergithubRepoIdintegernamestringorgIdstringrepostringThe GitHub repository as `owner/name`, instead of `githubInstallationId` + `githubRepoId`.rootDirectorysetupWithAgentbooleantemplatestring
project_delete1 paramDelete a project. Deletes the project and every VM in it. This cannot be undone.
Show parametersHide parameters
projectIdstringrequired
project_get1 paramGet a project
Show parametersHide parameters
projectIdstringrequired
project_list1 paramList projects. Every project in your teams, newest first. Pass `orgId` for one team's projects.
Show parametersHide parameters
orgIdstring
project_update12 paramsUpdate project settings. Changes the project's slug, default branch, default auto-sleep and other settings. Every field is optional.
Show parametersHide parameters
projectIdstringrequiredbootTimeoutSecondsdefaultBranchstringdefaultSleepAfterMinutesiconiconColorkeepServicesRunningbooleanlinearTriggerLabelprPreviewsEnabledbooleanrootDirectoryslugstringwakeOnVisitboolean
sandbox_create6 paramsCreate 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 is deleted when `ttlMinutes` runs out (default 60, at most 1440).
Show parametersHide parameters
envobjectEnv vars every command run through this API gets. Stored encrypted.orgIdstringThe team it belongs to. Defaults to your first team (an API key's own team).projectIdstringStart from this project's current image instead of the plain base image.regionstringsizestringttlMinutesintegerMinutes until the sandbox is deleted. Default 60, at most 1440.
sandbox_delete1 paramDelete a sandbox. Deletes the sandbox and everything in it. This cannot be undone.
Show parametersHide parameters
sandboxIdstringrequired
sandbox_exec6 paramsRun 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. Use `?stream=1` for commands that run longer than about 90 seconds.
Show parametersHide parameters
streamstringsandboxIdstringrequiredcommandstringrequiredcwdstringenvobjecttimeoutMsinteger
sandbox_extend2 paramsExtend a sandbox. Sets how long the sandbox lives from now: `ttlMinutes`, at most 1440 (24 hours).
Show parametersHide parameters
sandboxIdstringrequiredttlMinutesintegerrequiredMinutes from now until the sandbox is deleted. At most 1440.
sandbox_get1 paramGet a sandbox. One sandbox: its state, size and when it is deleted.
Show parametersHide parameters
sandboxIdstringrequired
sandbox_listList sandboxes. Every sandbox in your teams that is not deleted, oldest first.
sandbox_read_file3 paramsRead a file. Reads a file from the sandbox as text, or as base64 with `encoding=base64`. At most 10 MB.
Show parametersHide parameters
encodingstringpathstringrequiredAbsolute, or relative to the sandbox's home directory.sandboxIdstringrequired
sandbox_write_file4 paramsWrite 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.
Show parametersHide parameters
sandboxIdstringrequiredcontentstringrequiredThe file's content, as text or base64 (see `encoding`).encodingstringpathstringrequiredAbsolute, or relative to the sandbox's home directory.
setup_report5 paramsReport 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 Doctor starts, `done` with the pull request, or `failed` with a one-line reason. It only changes the setup of the person you are signed in as.
Show parametersHide parameters
agentstringYour name as the person knows you, e.g. "Claude Code", "Codex" or "Cursor".messagestringOne line for the person: why setup stopped (`failed`), or what now works (`done`).prUrlstringThe pull request with the project's `.homemade/config.jsonc` (`done`).projectIdstringThe project's id or slug (from `homemade project create`). Required for `project`.stepstringrequired`connected` right after signing in, `project` once the project exists, `checking` when Project Doctor starts, `done` when the config is tested and the pull requ
shell_delete2 paramsEnd a terminal session
Show parametersHide parameters
vmIdstringrequiredsessionIdstringrequired
shell_list1 paramList terminal sessions. The VM's open terminals. Each one keeps running when nobody is attached.
Show parametersHide parameters
vmIdstringrequired
ssh_key_add2 paramsAdd an SSH key. Adds an SSH public key. Running VMs in your teams accept it within seconds.
Show parametersHide parameters
labelstringrequiredpublicKeystringrequired
ssh_key_delete1 paramRemove an SSH key
Show parametersHide parameters
idstringrequired
ssh_key_listList SSH keys
vm_create8 paramsCreate 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`.
Show parametersHide parameters
branchstringkeepServicesRunningbooleannamestringparameterValuesobjectprojectIdstringrequiredregionstringsizestringticketobject
vm_delete1 paramDelete a VM. Deletes the VM and its data. This cannot be undone.
Show parametersHide parameters
vmIdstringrequired
vm_dismiss_signal1 paramDismiss the agent signal. Clears the attention signal an agent in the VM raised. Does nothing when there is none.
Show parametersHide parameters
vmIdstringrequired
vm_exec6 paramsRun 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.
Show parametersHide parameters
streamstringvmIdstringrequiredcommandstringrequiredcwdstringenvobjecttimeoutMsinteger
vm_get1 paramGet a VM. The VM, its project, its services and its newest events. `vm.urls` holds each service's public URL by port.
Show parametersHide parameters
vmIdstringrequired
vm_list1 paramList VMs. Every VM in your teams that is not deleted, newest first. Pass `projectId` to list one project's VMs.
Show parametersHide parameters
projectIdstring
vm_sleep1 paramSleep 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.
Show parametersHide parameters
vmIdstringrequired
vm_update5 paramsUpdate a VM. Renames the VM, changes its auto-sleep or who can open its services. Every field is optional.
Show parametersHide parameters
vmIdstringrequiredkeepServicesRunningboolean | nullnamestringshareLevelsobjectsleepAfterMinutesinteger
vm_wake1 paramWake a VM. Wakes an asleep VM. Poll `GET /api/vms/{vmId}` until `state` is `running`.
Show parametersHide parameters
vmIdstringrequired
Get the current user. The key's owner and the teams it can reach. A team's `id` is the `orgId` other calls take.
Checked by Serverdex with a plain initialize + tools/list call to api.homemade.dev/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 21, 2026- Stars
- 0
- Forks
- 0
- Last push
- Nov 17, 2026
- License
- —
ai-agentsclaude-codecloud-developmentcodexdev-environmentmcpmicrovmremote-development
From the README
homemade CLI releases Standalone homemade CLI binaries, published by the homemade-dev cli-release workflow. Install: curl -fsSL https://homemade.dev/install.sh | bash
Read the full README on GitHub →Remotes
- streamable-http
https://api.homemade.dev/mcp
Alternatives to Homemade
All Homemade alternatives →Best Developer Tools servers →The most-starred Developer Tools servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| REA | 466,935 | Nov 2026 | Local / not checked |
| GitHub | 34,658 | Nov 2026 | Needs sign-in |
| Repomix | 29,280 | Nov 2026 | Local / not checked |
| Compiler Explorer | 19,201 | Nov 2026 | Working |
| XERJ | 19,135 | Nov 2026 | Local / not checked |
Homemade: questions people ask
- Is Homemade a remote or a local MCP server?
- According to its entry in the official MCP registry, Homemade ships as a hosted endpoint (streamable-http) that your client connects to by URL.
- Does Homemade need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is Homemade safe to use?
- Mostly fine: Homemade is maintained, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: No licence found; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is Homemade still maintained?
- Active: the repository's last commit 5 days ago. Last push Nov 17, 2026, 0 GitHub stars. Read from GitHub on Nov 21, 2026.
- What tools does Homemade expose?
- 38 tools as listed by the server itself during the live check, including api_key_delete, api_key_list, api_key_rename, chat_delete, chat_list. The full list with parameters is in the Live check section above.
- How do I add Homemade to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More Developer Tools servers
Browse all Developer Tools →Hydrant
Background-Craft
Track issues, projects and dependencies with your agent in a workspace you control.
Krusch Coding Harness
kruschdev
Two-phase commit coding harness that stages diffs, runs sandboxed tests, and applies atomically.
Krusch Git MCP
kruschdev
Git DAG, AST symbol chunking, call-graph blast radius, and hybrid RRF code search MCP server.
lastseen mortality
agentidx
Check whether an npm package, GitHub Action, MCP server or Docker image is dead or abandoned.
LibraryAPI
library-api
US public libraries and branches near any address, with collections from the IMLS survey
minitok
floticinfo
Verified coding workflows with planning, verification, bounded retries, evidence, and evolution.
Add the badge to your site
Show visitors that Homemade is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/dev-homemade-homemade?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Homemade — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/dev-homemade-homemade?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/dev-homemade-homemade) [](https://serverdex.io/install/vscode/dev-homemade-homemade) [](https://serverdex.io/install/claude-code/dev-homemade-homemade)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/dev-homemade-homemade"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/dev-homemade-homemade"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/dev-homemade-homemade"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).