Hostbeam
Lets a coding agent read the screenshots you beam to its server with Hostbeam.
Open source Open in the app JSON README (API)
About
Lets a coding agent read the screenshots you beam to its server with Hostbeam.
Details
- Kind
- MCP servers
- Topic
- Web search, scraping & browser
- Publisher
- app.hostbeam
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.0
- Last push
- 2026-09-14T00:24:45Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-09-14 01:02:53
- Updated
- 2026-09-14 01:02:53
- Origin id
app.hostbeam/mcp
README
# Hostbeam MCP server
[Hostbeam](https://hostbeam.app) sends a screenshot from your Mac to a server
over SSH and puts the remote path on your clipboard, so you can paste it to a
coding agent running there.
This MCP server runs on that server, next to the agent. The agent can ask for
the screenshot you just beamed and read it, without you pasting the path.
## Install
On the server your agent runs on, not on your Mac. Node 18 or later.
For Claude Code:
```sh
claude mcp add -s user hostbeam -- npx -y @hostbeam/mcp
```
`-s user` makes it available in every project on that server.
For other MCP clients, in their JSON config:
```json
{
"mcpServers": {
"hostbeam": {
"command": "npx",
"args": ["-y", "@hostbeam/mcp"]
}
}
}
```
If the server can't reach npm, copy `hostbeam-mcp.mjs` to it and run that
instead. It has no dependencies.
```sh
claude mcp add -s user hostbeam -- node /path/to/hostbeam-mcp.mjs
```
Hostbeam beams to `/tmp/hostbeam` unless you changed the folder for that host.
If you did, give the server the same folder: `-e HOSTBEAM_DIR=/your/folder` for
Claude Code, or `"env": { "HOSTBEAM_DIR": "/your/folder" }` in JSON.
## Tools
- **`latest_screenshot`** returns the most recent beam as images, with how long
ago it arrived. If you beamed several files at once, it returns all of them,
up to six, and names the rest.
- **`list_screenshots`** lists recent beams with file names, sizes and times. No
image data.
- **`read_screenshot`** returns one file by name.
## What it reads
Only files Hostbeam delivered: names starting with `hostbeam-` with an image
extension, in that one folder. It doesn't look in subfolders, and it refuses a
name with a path in it. It never writes, moves or deletes anything.
JPEG, PNG, GIF and WebP come back as images. Other formats, and anything over
8 MB, come back as a path instead, because models only accept those four as
images.
## Check it by hand
It speaks newline-delimited JSON-RPC on stdin and stdout:
```sh
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_screenshots"}}' \
| npx -y @hostbeam/mcp
```
## License
MIT