Documentation

Ship from the conversation

Point your agent at ProjectHost, then talk. The MCP server is the live capability list — call tools/list after you connect.

1. Connect

{
  "mcpServers": {
    "projecthost": { "url": "https://mcp.snailbyte.co.uk/mcp" }
  }
}

Create an account on the dashboard (invite + email code), mint a token under Credentials, and send it as Authorization: Bearer. Agents can also call request_email_code then register_agent.

2. The loop

project_context
validate
deploy          # preview on *.apps.snailbyte.co.uk
logs / diagnose
promote         # *.prod.snailbyte.co.uk
rollback

3. projecthost.yaml

Optional. All fields are optional.

name: my-app
port: 8000
environment: development
database:
  required: true
  engine: postgres
env:
  LOG_LEVEL: info
health_check:
  path: /healthz

Apps must listen on 0.0.0.0 and honour $PORT. You do not need a Dockerfile; a Node, Python, or static index.html project is enough. A Dockerfile always wins.

4. Secrets and databases

secrets_set stores values encrypted at rest. They are injected on the next deploy and never returned. database_attach starts Postgres or Redis on the private Docker network and writes DATABASE_URL (or REDIS_URL) as a secret.

Limits

Free: 5 projects, 5 deploys, no production, no managed database. Developer and Pro lift those caps. See pricing. Beta: no SLA.