io.github.SeanFDZ/agentbridge

NPM · CLASSIC-MAC-MCP · SCANNED AUG 3

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

Available components

+23 this week 69 69 Trust /100

Trust breakdown (6 categories)

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. How we score →

Supply Chain Security86

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (GPL-3.0).Pass
Actively maintained (last published 112 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 1585 tokens (~68/item across 23 items; 23 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · classic-mac-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# add to Codex CLI

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
    }
  }
}

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +44
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: GPL-3.0 functional
1 Aug 26 −17
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 +13
- Provenance: unverified → fail ▼ security
- Malware scan: pass → unverified ▼ security
- Install scripts: unverified → pass ▲ security
- Dependency health: partial → unverified ▼ functional
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Licence: GPL-3.0 functional
29 Jul 26 −21
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- First check of Schema quality: unverified functional
27 Jul 26 46

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 23 exposed · ~1,585 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

classic_mac_activate_app ~57

Bring a running application to the front. Requires AgentBridge.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Application name (e.g. 'SimpleText')
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_click ~101

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

Input Output Examples

Name	Type	Req	Description
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	yes	X coordinate
y	number	yes	Y coordinate

No output schema declared.

No examples provided.

classic_mac_get_about ~57

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_get_clipboard ~45

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_get_front_window ~49

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_get_menu_items ~69

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

Input Output Examples

Name	Type	Req	Description
menu	string	yes	Menu title (e.g. 'File', 'Edit')
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_get_volumes ~47

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_heartbeat ~55

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_key_press ~124

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

Input Output Examples

Name	Type	Req	Description
key	string	yes	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.

No output schema declared.

No examples provided.

classic_mac_launch_app ~125

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 Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

classic_mac_list_folder ~94

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 Output Examples

Name	Type	Req	Description
path	string	yes	HFS path using ':' separator (e.g. 'Macintosh HD:System Folder')
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_list_menus ~49

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_list_processes ~56

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_list_targets ~36

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

classic_mac_list_windows ~57

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_menu_select ~89

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

Input Output Examples

Name	Type	Req	Description
item	string	yes	Menu item name (e.g. 'Save As...')
menu	string	yes	Menu title (e.g. 'File')
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_mouse_drag ~78

Click and drag from one point to another.

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.
x1	number	yes	Start X
x2	number	yes	End X
y1	number	yes	Start Y
y2	number	yes	End Y

No output schema declared.

No examples provided.

classic_mac_mouse_move ~56

Move the cursor to screen coordinates without clicking.

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.
x	number	yes	X coordinate
y	number	yes	Y coordinate

No output schema declared.

No examples provided.

classic_mac_ping ~41

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_quit_app ~57

Quit a running application by name. Requires AgentBridge.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Application name (e.g. 'SimpleText')
target	string	—	Target ID or alias. Optional if only one target is configured.

No output schema declared.

No examples provided.

classic_mac_send_appleevent ~109

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 Output Examples

Name	Type	Req	Description
app	string	yes	Target app name or creator code
event	string	yes	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.

No output schema declared.

No examples provided.

classic_mac_set_clipboard ~68

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

Input Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.
text	string	yes	Text to place on clipboard

No output schema declared.

No examples provided.

classic_mac_type_text ~66

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 Output Examples

Name	Type	Req	Description
target	string	—	Target ID or alias. Optional if only one target is configured.
text	string	yes	Text to type

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug