Homemade

● Active

dev.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.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "homemade": {
      "url": "https://api.homemade.dev/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http homemade https://api.homemade.dev/mcp
VS Code
code --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
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly 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 →
● Working781 msprotocol 2025-06-18v1.0.0tools

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 param

    Delete an API key. Revokes the key at once. Requests that use it get 401 from then on.

    Show parameters
    • keyIdstringrequired
  • api_key_list

    List API keys. Your API keys. The secret itself is shown only once, when the key is created.

  • api_key_rename2 params

    Rename an API key

    Show parameters
    • keyIdstringrequired
    • namestringrequired
  • chat_delete2 params

    End an agent chat

    Show parameters
    • vmIdstringrequired
    • sessionIdstringrequired
  • chat_list1 param

    List agent chats

    Show parameters
    • vmIdstringrequired
  • chat_new1 param

    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.

    Show parameters
    • vmIdstringrequired
  • chat_send5 params

    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.

    Show parameters
    • vmIdstringrequired
    • messagestringrequired
    • modelstring
    • permissionModestring
    • sessionIdstring
  • config_validate2 params

    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.

    Show parameters
    • contentstringrequired
    • pathstringrequired
  • project_branches1 param

    List branches. The branches a VM of this project can boot, the default branch first.

    Show parameters
    • projectIdstringrequired
  • project_create10 params

    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; `welcomeVm` says how that went.

    Show parameters
    • configobject
    • defaultBranchstring
    • githubInstallationIdinteger
    • githubRepoIdinteger
    • namestring
    • orgIdstring
    • repostringThe GitHub repository as `owner/name`, instead of `githubInstallationId` + `githubRepoId`.
    • rootDirectory
    • setupWithAgentboolean
    • templatestring
  • project_delete1 param

    Delete a project. Deletes the project and every VM in it. This cannot be undone.

    Show parameters
    • projectIdstringrequired
  • project_get1 param

    Get a project

    Show parameters
    • projectIdstringrequired
  • project_list1 param

    List projects. Every project in your teams, newest first. Pass `orgId` for one team's projects.

    Show parameters
    • orgIdstring
  • project_update12 params

    Update project settings. Changes the project's slug, default branch, default auto-sleep and other settings. Every field is optional.

    Show parameters
    • projectIdstringrequired
    • bootTimeoutSeconds
    • defaultBranchstring
    • defaultSleepAfterMinutes
    • icon
    • iconColor
    • keepServicesRunningboolean
    • linearTriggerLabel
    • prPreviewsEnabledboolean
    • rootDirectory
    • slugstring
    • wakeOnVisitboolean
  • sandbox_create6 params

    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 is deleted when `ttlMinutes` runs out (default 60, at most 1440).

    Show 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.
    • regionstring
    • sizestring
    • ttlMinutesintegerMinutes until the sandbox is deleted. Default 60, at most 1440.
  • sandbox_delete1 param

    Delete a sandbox. Deletes the sandbox and everything in it. This cannot be undone.

    Show parameters
    • sandboxIdstringrequired
  • sandbox_exec6 params

    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. Use `?stream=1` for commands that run longer than about 90 seconds.

    Show parameters
    • streamstring
    • sandboxIdstringrequired
    • commandstringrequired
    • cwdstring
    • envobject
    • timeoutMsinteger
  • sandbox_extend2 params

    Extend a sandbox. Sets how long the sandbox lives from now: `ttlMinutes`, at most 1440 (24 hours).

    Show parameters
    • sandboxIdstringrequired
    • ttlMinutesintegerrequiredMinutes from now until the sandbox is deleted. At most 1440.
  • sandbox_get1 param

    Get a sandbox. One sandbox: its state, size and when it is deleted.

    Show parameters
    • sandboxIdstringrequired
  • sandbox_list

    List sandboxes. Every sandbox in your teams that is not deleted, oldest first.

  • sandbox_read_file3 params

    Read a file. Reads a file from the sandbox as text, or as base64 with `encoding=base64`. At most 10 MB.

    Show parameters
    • encodingstring
    • pathstringrequiredAbsolute, or relative to the sandbox's home directory.
    • sandboxIdstringrequired
  • sandbox_write_file4 params

    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.

    Show parameters
    • sandboxIdstringrequired
    • contentstringrequiredThe file's content, as text or base64 (see `encoding`).
    • encodingstring
    • pathstringrequiredAbsolute, or relative to the sandbox's home directory.
  • setup_report5 params

    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 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 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 params

    End a terminal session

    Show parameters
    • vmIdstringrequired
    • sessionIdstringrequired
  • shell_list1 param

    List terminal sessions. The VM's open terminals. Each one keeps running when nobody is attached.

    Show parameters
    • vmIdstringrequired
  • ssh_key_add2 params

    Add an SSH key. Adds an SSH public key. Running VMs in your teams accept it within seconds.

    Show parameters
    • labelstringrequired
    • publicKeystringrequired
  • ssh_key_delete1 param

    Remove an SSH key

    Show parameters
    • idstringrequired
  • ssh_key_list

    List SSH keys

  • vm_create8 params

    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`.

    Show parameters
    • branchstring
    • keepServicesRunningboolean
    • namestring
    • parameterValuesobject
    • projectIdstringrequired
    • regionstring
    • sizestring
    • ticketobject
  • vm_delete1 param

    Delete a VM. Deletes the VM and its data. This cannot be undone.

    Show parameters
    • vmIdstringrequired
  • vm_dismiss_signal1 param

    Dismiss the agent signal. Clears the attention signal an agent in the VM raised. Does nothing when there is none.

    Show parameters
    • vmIdstringrequired
  • vm_exec6 params

    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.

    Show parameters
    • streamstring
    • vmIdstringrequired
    • commandstringrequired
    • cwdstring
    • envobject
    • timeoutMsinteger
  • vm_get1 param

    Get a VM. The VM, its project, its services and its newest events. `vm.urls` holds each service's public URL by port.

    Show parameters
    • vmIdstringrequired
  • vm_list1 param

    List VMs. Every VM in your teams that is not deleted, newest first. Pass `projectId` to list one project's VMs.

    Show parameters
    • projectIdstring
  • vm_sleep1 param

    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.

    Show parameters
    • vmIdstringrequired
  • vm_update5 params

    Update a VM. Renames the VM, changes its auto-sleep or who can open its services. Every field is optional.

    Show parameters
    • vmIdstringrequired
    • keepServicesRunningboolean | null
    • namestring
    • shareLevelsobject
    • sleepAfterMinutesinteger
  • vm_wake1 param

    Wake a VM. Wakes an asleep VM. Poll `GET /api/vms/{vmId}` until `state` is `running`.

    Show 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-httphttps://api.homemade.dev/mcp

The most-starred Developer Tools servers in the index, with their live-check result.

ServerStarsLast pushLive check
REA466,935Nov 2026Local / not checked
GitHub34,658Nov 2026Needs sign-in
Repomix29,280Nov 2026Local / not checked
Compiler Explorer19,201Nov 2026Working
XERJ19,135Nov 2026Local / 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.
Browse all Developer Tools →

Add the badge to your site

Show visitors that Homemade is listed here — it’s also the link we check for a free listing.

Homemade — listed on Serverdex

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

[![Homemade — listed on Serverdex](https://serverdex.io/brand/badge.svg)](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.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/dev-homemade-homemade) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/dev-homemade-homemade) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](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).