Shipholm
Publish a GitHub repository as a live HTTPS app, operated over MCP. Start here; the other
shipholm-* skills cover each kind of app.
Connect
Shipholm is a remote MCP server (streamable HTTP):
- URL:
https://api.shipholm.com/mcp - Header:
Authorization: Bearer <API key>
If the Shipholm tools (get_platform_info, create_app …) are not available, ask your human to sign in at https://app.shipholm.com, create an API key and connect it – configuration for each agent is at https://shipholm.com/docs/agents. Never put the key in a repository, a shared prompt or a log.
First call
get_platform_info returns your account, the GitHub repositories you may build from (github_sources) and the contract every app follows:
- listen on
$PORT, answer the health check (health_path, default/) with 200; - runs as uid 10001 with a read-only filesystem – only
/tmpis writable, and/data(DATA_DIR) withstorage=true, the only path that survives a restart; DATABASE_URLwithdatabase=true.
A private repository needs the GitHub account connected once: call connect_github and give the link to your human.
Publish
- Push the code to GitHub (a
Dockerfileis used if there is one, otherwise Railpack builds Node/Vite/Next, Python, Go and more). create_app(app="<name>", source_repo="https://github.com/<owner>/<repo>")– addstorage=true,database=true,previews=trueorscale_to_zero=trueas the app needs.- Poll
app_statusuntilready=true(the first build takes a few minutes); readapp_logson errors. - The app answers on
https://<name>.shipholm.dev– names are global,<name>-01… when taken (check_hostbefore,update_app(host=...)to change it). Every push deploys again.
Pick the skill for the job
shipholm-static-site– a frontend, a game or plain HTML with no backend.shipholm-sqlite-app– an app with its own data in SQLite on a disk (the light default).shipholm-postgres-app– an app with its own Postgres.shipholm-env-and-secrets– configuration and API keys.shipholm-custom-domain– the user's own domain.shipholm-migrate-from-lovable– a Lovable app, with or without Supabase.
The same skills are available over MCP (list_skills, get_skill), so agents without a skills folder can read them too.
Limits
get_account shows the plan and its usage (the free plan allows 2 apps). Humans manage the account, apps, domains and keys in the portal: https://app.shipholm.com
Use when: Deploy and run apps on Shipholm, the EU hosting platform that agents operate over MCP – publish a GitHub repository and get a live HTTPS address. Use when the user wants an app, site or game published, hosted or deployed on Shipholm, or asks about its apps, logs, addresses or plan.
For agents: get_skill("shipholm") over MCP, or the SKILL.md at https://api.shipholm.com/skills/shipholm/SKILL.md.