---
name: shipholm
description: "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."
---

# 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 `/tmp` is writable, and `/data`
  (`DATA_DIR`) with `storage=true`, the only path that survives a restart;
- `DATABASE_URL` with `database=true`.

A private repository needs the GitHub account connected once: call `connect_github` and give the
link to your human.

## Publish
1. Push the code to GitHub (a `Dockerfile` is used if there is one, otherwise Railpack builds
   Node/Vite/Next, Python, Go and more).
2. `create_app(app="<name>", source_repo="https://github.com/<owner>/<repo>")` – add
   `storage=true`, `database=true`, `previews=true` or `scale_to_zero=true` as the app needs.
3. Poll `app_status` until `ready=true` (the first build takes a few minutes); read `app_logs`
   on errors.
4. The app answers on `https://<name>.shipholm.dev` – names are global, `<name>-01` … when taken
   (`check_host` before, `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
