# Fiskmås

Fiskmås is an MCP-native Docker app host. Humans talk to their existing AI
client; the client talks to Fiskmås over MCP. Hosting is the durable piece.

> Connect to the Fiskmås MCP, create a project, push a Docker image to the
> registry, and deploy it — all from an agent with only the MCP URL and a skill.

## Connect

- MCP (Streamable HTTP): https://mcp.fiskmas.dev/mcp
- Skill: https://fiskmas.dev/skill.md  (also `skill://fiskmas` via MCP)
- Docker contract: https://fiskmas.dev/docker-contract.md
- Prefer MCP tools; avoid curl/REST against fiskmas.dev as a workaround.
- If MCP tools are missing: configure the server yourself in the client
  (Claude Code `.mcp.json` / Cursor `.cursor/mcp.json`), auth via env
  `FISKMAS_TOKEN` → `Authorization: Bearer`, reload if needed — see skill.md.
- Account: MCP `create_account` (email required) or `POST /api/register` —
  emails a human verify link; the verify page shows the API token once.
  Store it as `FISKMAS_TOKEN` / MCP Bearer, then `whoami`. Same token for
  `docker login -u "$FISKMAS_TOKEN" registry.fiskmas.dev`.

## Tools

- create_account, account_status, reissue_token, whoami, delete_account
- create_project, list_projects, get_project, delete_project
- set_env, list_env
- deploy_project, start_project, stop_project, restart_project
- get_status, get_logs, get_stats
- send_feedback
- list_skills, get_skill

## Plans

- **Free** ($0): 1 running project
  (sleeps after 24 h idle), 256 MB / 0.2 CPU per project, 24 h log window
  (200-line tail), ~256 MB fair-use database.
- **Plus** ($9.99/mo, Stripe, no trial):
  5 always-on projects,
  512 MB / 1 CPU per project, 7 d log window (2,000-line tail),
  ~1 GB fair-use database.
- Upgrading is a human step on https://fiskmas.dev/#pricing (Upgrade to Plus
  → API token → Stripe Checkout; the webhook flips the plan, then `whoami`
  reports `plus`). Plan-limit errors name the price and the upgrade page —
  relay them to the human instead of retrying.

## Skills

- fiskmas: Use Fiskmås, an MCP-native Docker app host, to deploy a containerized HTTP app. Use when the user wants to host, deploy, run, stop, or debug a Docker app reachable over HTTPS via an MCP client.
- fiskmas-debug: Debug a Fiskmås app that is unhealthy. Use when an app returns 502, is in a crash loop, fails its health check, or when deciding between restart and redeploy.
- fiskmas-docker: Write a Fiskmås-compatible Dockerfile. Use when building an image to deploy to Fiskmås — PORT, health path, amd64, size and memory caps, non-root, and no secrets baked in.

## Docker contract

HTTP only, listen on `0.0.0.0:$PORT` (PORT=8080), a health path, non-root if
possible, no privileged mode / docker.sock / extra ports, linux/amd64,
stateless, no secrets baked in (env vars only). Per-project caps are
plan-driven: 256 MB / 0.2 CPU on Free, 512 MB / 1 CPU on Plus.

---
Generated 2026-10-26. Source of truth lives in-repo (skills/, src/mcp/tools.ts).