{
  "markdown": "# Hostbeam MCP server\n\n[Hostbeam](https://hostbeam.app) sends a screenshot from your Mac to a server\nover SSH and puts the remote path on your clipboard, so you can paste it to a\ncoding agent running there.\n\nThis MCP server runs on that server, next to the agent. The agent can ask for\nthe screenshot you just beamed and read it, without you pasting the path.\n\n## Install\n\nOn the server your agent runs on, not on your Mac. Node 18 or later.\n\nFor Claude Code:\n\n```sh\nclaude mcp add -s user hostbeam -- npx -y @hostbeam/mcp\n```\n\n`-s user` makes it available in every project on that server.\n\nFor other MCP clients, in their JSON config:\n\n```json\n{\n  \"mcpServers\": {\n    \"hostbeam\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@hostbeam/mcp\"]\n    }\n  }\n}\n```\n\nIf the server can't reach npm, copy `hostbeam-mcp.mjs` to it and run that\ninstead. It has no dependencies.\n\n```sh\nclaude mcp add -s user hostbeam -- node /path/to/hostbeam-mcp.mjs\n```\n\nHostbeam beams to `/tmp/hostbeam` unless you changed the folder for that host.\nIf you did, give the server the same folder: `-e HOSTBEAM_DIR=/your/folder` for\nClaude Code, or `\"env\": { \"HOSTBEAM_DIR\": \"/your/folder\" }` in JSON.\n\n## Tools\n\n- **`latest_screenshot`** returns the most recent beam as images, with how long\n  ago it arrived. If you beamed several files at once, it returns all of them,\n  up to six, and names the rest.\n- **`list_screenshots`** lists recent beams with file names, sizes and times. No\n  image data.\n- **`read_screenshot`** returns one file by name.\n\n## What it reads\n\nOnly files Hostbeam delivered: names starting with `hostbeam-` with an image\nextension, in that one folder. It doesn't look in subfolders, and it refuses a\nname with a path in it. It never writes, moves or deletes anything.\n\nJPEG, PNG, GIF and WebP come back as images. Other formats, and anything over\n8 MB, come back as a path instead, because models only accept those four as\nimages.\n\n## Check it by hand\n\nIt speaks newline-delimited JSON-RPC on stdin and stdout:\n\n```sh\nprintf '%s\\n' \\\n  '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{}}' \\\n  '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"list_screenshots\"}}' \\\n  | npx -y @hostbeam/mcp\n```\n\n## License\n\nMIT\n",
  "bytes": 2233,
  "sha": "cbcc05f1e87d7bbee26f2e24cefa7f2d07d526b7427b2e191749b12795bde6eb",
  "repo_slug": "punkabeat/hostbeam-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_hostbeam_mcp_b6e1f5da/readme"
}