# io.github.SeanFDZ/agentbridge (npm · classic-mac-mcp)

Control Classic Mac OS (System 7-9) from AI agents via shared folder protocol.

- Trust score: 69/100 (medium)
- Change this week: +23
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `classic-mac-mcp`: 69/100 (this document), [markdown](https://verifymcp.io/servers/seanfdz-agentbridge/classic-mac-mcp.md), [page](https://verifymcp.io/servers/seanfdz-agentbridge/classic-mac-mcp)

## Channel facts

- Registry: `npm`
- Package: `classic-mac-mcp`
- Version: `1.0.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (GPL-3.0).
  - Actively maintained (last published 112 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1585 tokens (~68/item across 23 items; 23 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add seanfdz-agentbridge -- npx -y classic-mac-mcp
```

### Codex

```bash
codex mcp add seanfdz-agentbridge -- npx -y classic-mac-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "seanfdz-agentbridge": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "classic-mac-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add seanfdz-agentbridge --command npx --arg -y --arg classic-mac-mcp
```

### Hermes

```yaml
mcp_servers:
  seanfdz-agentbridge:
    command: "npx"
    args: ["-y", "classic-mac-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "seanfdz-agentbridge": {
      "command": "npx",
      "args": [
        "-y",
        "classic-mac-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 69, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-08-02 (score 65, +44)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional] Licence: GPL-3.0

### 2026-08-01 (score 21, −17)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 38, +13)

- [security regression] Provenance: unverified → fail
- [security regression] Malware scan: pass → unverified
- [security improvement] Install scripts: unverified → pass
- [functional regression] Dependency health: partial → unverified
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] License: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional] Licence: GPL-3.0

### 2026-07-29 (score 25, −21)

- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Dependency health: unverified → partial
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (23)

### `classic_mac_list_targets` (~36 tokens)

List all Classic Mac targets in the fleet with their current status, including architecture, OS version, and whether AgentBridge is alive.

### `classic_mac_ping` (~41 tokens)

Ping a Classic Mac target to check if AgentBridge is responding.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_heartbeat` (~55 tokens)

Read the heartbeat status of a Classic Mac target. Returns uptime, front app, free memory, and whether the bridge is alive.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_list_windows` (~57 tokens)

List all visible windows on a Classic Mac target. Returns window title, owning application, screen bounds, and layer order. Requires AgentBridge.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_list_processes` (~56 tokens)

List running applications on a Classic Mac target. Returns app name, creator code, PID, and memory partition. Requires AgentBridge.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_list_menus` (~49 tokens)

List the menu bar contents for the frontmost application. Returns menu titles. Requires AgentBridge.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_get_menu_items` (~69 tokens)

Get all items in a specific menu, including enabled/disabled state and keyboard shortcuts. Requires AgentBridge.

Input parameters:

- `menu` (string, required): Menu title (e.g. 'File', 'Edit')
- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_get_front_window` (~49 tokens)

Get detailed info about the frontmost window: title, app, bounds. Requires AgentBridge.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_get_volumes` (~47 tokens)

List mounted volumes (disks) with free and total space. Requires AgentBridge.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_list_folder` (~94 tokens)

List contents of a folder on the Classic Mac. Returns file names, types, creator codes, and sizes. Path uses ':' as separator (e.g. 'Macintosh HD:Documents'). Requires AgentBridge.

Input parameters:

- `path` (string, required): HFS path using ':' separator (e.g. 'Macintosh HD:System Folder')
- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_get_about` (~57 tokens)

Get system information about a Classic Mac target: OS version, machine type, RAM, free memory, AgentBridge uptime. Requires AgentBridge.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_get_clipboard` (~45 tokens)

Read the clipboard (scrap) contents as text. Requires AgentBridge.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_set_clipboard` (~68 tokens)

Set the clipboard (scrap) to the given text. Useful for pasting content into Classic Mac applications. Requires AgentBridge.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.
- `text` (string, required): Text to place on clipboard

### `classic_mac_click` (~101 tokens)

Click at screen coordinates on a Classic Mac target. Coordinates are relative to the Mac's screen.

Input parameters:

- `button` (number): Mouse button (1=left, default 1)
- `clicks` (number): Number of clicks (1 or 2, default 1)
- `target` (string): Target ID or alias. Optional if only one target is configured.
- `x` (number, required): X coordinate
- `y` (number, required): Y coordinate

### `classic_mac_mouse_move` (~56 tokens)

Move the cursor to screen coordinates without clicking.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.
- `x` (number, required): X coordinate
- `y` (number, required): Y coordinate

### `classic_mac_mouse_drag` (~78 tokens)

Click and drag from one point to another.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.
- `x1` (number, required): Start X
- `x2` (number, required): End X
- `y1` (number, required): Start Y
- `y2` (number, required): End Y

### `classic_mac_type_text` (~66 tokens)

Type text on a Classic Mac target. Characters are typed one by one. Make sure the correct text field or application is focused first.

Input parameters:

- `target` (string): Target ID or alias. Optional if only one target is configured.
- `text` (string, required): Text to type

### `classic_mac_key_press` (~124 tokens)

Press a key with optional modifiers. Use for keyboard shortcuts (e.g. Cmd+S to save) and special keys (return, escape, arrows).

Input parameters:

- `key` (string, required): Key name: a-z, 0-9, return, tab, escape, space, delete, left, right, up, down, f1-f12, or any single character
- `modifiers` (string): Comma-separated modifiers: cmd, opt, shift, ctrl
- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_menu_select` (~89 tokens)

Select a menu item by menu title and item name (e.g. menu='File', item='Save As...'). Requires AgentBridge.

Input parameters:

- `item` (string, required): Menu item name (e.g. 'Save As...')
- `menu` (string, required): Menu title (e.g. 'File')
- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_launch_app` (~125 tokens)

Launch an application on the Classic Mac by path or creator code. Creator codes are 4-character identifiers (e.g. 'ttxt' for SimpleText, 'WILD' for HyperCard). Requires AgentBridge.

Input parameters:

- `creator` (string): 4-character creator code (e.g. 'ttxt', 'WILD', 'CWIE')
- `path` (string): HFS path to application (e.g. 'Macintosh HD:Applications:SimpleText')
- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_activate_app` (~57 tokens)

Bring a running application to the front. Requires AgentBridge.

Input parameters:

- `name` (string, required): Application name (e.g. 'SimpleText')
- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_quit_app` (~57 tokens)

Quit a running application by name. Requires AgentBridge.

Input parameters:

- `name` (string, required): Application name (e.g. 'SimpleText')
- `target` (string): Target ID or alias. Optional if only one target is configured.

### `classic_mac_send_appleevent` (~109 tokens)

Send a generic Apple Event to an application. TARGET is app name or creator code, EVENT is the event type (e.g. 'oapp'). Requires AgentBridge.

Input parameters:

- `app` (string, required): Target app name or creator code
- `event` (string, required): Apple Event type (e.g. 'oapp', 'odoc')
- `params` (string): Optional event parameters
- `target` (string): Target ID or alias. Optional if only one target is configured.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/seanfdz-agentbridge/classic-mac-mcp#diagnostics

## Score history

- 2026-08-03: 69
- 2026-08-02: 65
- 2026-08-01: 21
- 2026-07-31: 38
- 2026-07-29: 25
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/classic-mac-mcp
- Socket report: https://socket.dev/npm/package/classic-mac-mcp
- Repository: https://github.com/SeanFDZ/agentbridge
- Changelog RSS feed: https://verifymcp.io/servers/seanfdz-agentbridge/classic-mac-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/seanfdz-agentbridge/classic-mac-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/seanfdz-agentbridge/classic-mac-mcp