diff --git a/README.md b/README.md
index f3b60ac..bca9b61 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
 # homebrew-tap
 
-Homebrew tap for mcpctl and related CLIs
\ No newline at end of file
+Homebrew tap for `mcpctl` (and the bundled `claude-vllm` launcher).
+
+```sh
+brew tap michal/mcpctl https://mysources.co.uk/michal/homebrew-tap.git
+brew install michal/mcpctl/mcpctl
+```
+
+`mcpctl` is a self-contained bun-compiled binary (Linux x86_64); its only runtime
+dependency is `jq`. The formula installs the `mcpctl` CLI, the `claude-vllm` launcher,
+and bash/fish completions. The binary is published as a release asset on
+[`michal/mcpctl`](https://mysources.co.uk/michal/mcpctl/releases).
+
+In the Bazzite desktop-setup Pulumi project, `mcplocal` runs as a rootless podman
+quadlet container (not from this tap); this tap provides only the CLI.
\ No newline at end of file