Shipholm
Sign inStart free

Docs

Quickstart: from account to live app

You need a GitHub account and a coding agent that supports MCP. The whole thing takes a few minutes.

1. Create an account

Open the portal and sign in with GitHub. The first sign-in creates your account on the free plan (2 apps) and shows your first API key – once. Copy it.

You can create more keys under API keys, one per agent, and revoke them separately.

2. Connect your agent

Shipholm is a remote MCP server:

URL:     https://api.build.agenthotel.org/mcp
Header:  Authorization: Bearer <your API key>

In Claude Code that is one command:

claude mcp add --transport http shipholm https://api.build.agenthotel.org/mcp \
  --header "Authorization: Bearer <your API key>"

Configuration for Codex, Cursor, VS Code, opencode, Hermes, Windsurf and Claude Desktop: Connect an agent.

3. Ask your agent to publish

Use the Shipholm MCP server. Call get_platform_info first, then publish
https://github.com/<you>/<repo> as an app and tell me its URL when it is ready.

The agent calls create_app, waits with app_status until ready is true (the first build takes a few minutes) and gives you the address: https://<app>-<account>.build.agenthotel.org.

From then on every push to the branch is deployed automatically. Nobody calls Shipholm again for a new version.

Private repositories

Public repositories work at once. For private ones – and instant builds on push – install the Shipholm GitHub App: your agent calls connect_github and gives you a link, or use GitHub in the portal. You choose which repositories it may read.

The contract every app follows

TopicRule
PortListen on $PORT (default 8080)
HealthAnswer HTTP 200 on / (or the health_path you set)
UserThe container runs as uid 10001, never as root
FilesystemRead-only except /tmp; keep data in the database
DatabaseDATABASE_URL points at the app's own Postgres (unless created with database=false)
BuildYour Dockerfile if there is one; otherwise detected (Node, Vite, Next.js, Python, Go, static sites …)
Settingsenv values are stored in plain text – do not put secrets there

The tools your agent gets

ToolWhat it does
get_platform_infoYour account, the contract above, the GitHub sources you may build from
create_app · update_app · delete_appCreate an app from a repository or an image, change it, remove it
list_apps · get_appWhat you have and how it is set up
app_statusReady or not, with hints about what to do when it is not
app_logsThe app's output, also from the previous crash
add_domain · verify_domain · remove_domainYour own domain
connect_githubA link for you to connect a GitHub account or organisation
get_accountYour plan, its limits and what you use

A static site or a game without a build step

Add this Dockerfile to the repository and ask the agent to create the app with database=false and scale_to_zero=true:

FROM python:3.13-slim
ENV PYTHONDONTWRITEBYTECODE=1 PORT=8080
WORKDIR /site
COPY . .
USER 10001
CMD ["sh", "-c", "exec python3 -m http.server \"$PORT\" --bind 0.0.0.0"]

When something is wrong