Agentbridge MCP server

by SeanFDZ·io.github.SeanFDZ/agentbridge·v1.0.2·26 stars

No reviews yet

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

B82/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B82/100

full report

Adoption

Growing

26 stars43 downloads/wk

Reviews

Write one

Nobody has reviewed Agentbridge yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Agentbridge tools (23, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

classic_mac_activate_app
Bring a running application to the front. Requires AgentBridge.
classic_mac_click
Click at screen coordinates on a Classic Mac target.
classic_mac_get_about
Get system information about a Classic Mac target: OS version,
classic_mac_get_clipboard
Read the clipboard (scrap) contents as text. Requires AgentBridge.
classic_mac_get_front_window
Get detailed info about the frontmost window: title, app, bounds.
classic_mac_get_menu_items
Get all items in a specific menu, including enabled/disabled state
classic_mac_get_volumes
List mounted volumes (disks) with free and total space. Requires AgentBridge.
classic_mac_heartbeat
Read the heartbeat status of a Classic Mac target. Returns uptime,
classic_mac_key_press
Press a key with optional modifiers. Use for keyboard shortcuts
classic_mac_launch_app
Launch an application on the Classic Mac by path or creator code.
classic_mac_list_folder
List contents of a folder on the Classic Mac. Returns file names,
classic_mac_list_menus
List the menu bar contents for the frontmost application.
classic_mac_list_processes
List running applications on a Classic Mac target. Returns app name,
classic_mac_list_targets
List all Classic Mac targets in the fleet with their current status,
classic_mac_list_windows
List all visible windows on a Classic Mac target. Returns window title,
classic_mac_menu_select
Select a menu item by menu title and item name
classic_mac_mouse_drag
Click and drag from one point to another.
classic_mac_mouse_move
Move the cursor to screen coordinates without clicking.
classic_mac_ping
Ping a Classic Mac target to check if AgentBridge is responding.
classic_mac_quit_app
Quit a running application by name. Requires AgentBridge.
classic_mac_send_appleeventwrite action
Send a generic Apple Event to an application. TARGET is app name or
classic_mac_set_clipboard
Set the clipboard (scrap) to the given text. Useful for pasting
classic_mac_type_text
Type text on a Classic Mac target. Characters are typed one by one.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan10 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 160 days ago8/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Agentbridge compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 82/100; higher than 63% of 48,255 servers
Tools: 23; the typical server has 7
Tools that change things: 4%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 26; more than 91% of 28,688 servers
Downloads a week: 43; more than 35% of 12,191 servers with a package

What its tools let an agent do: 22 read · 1 change

Install Agentbridge in Claude Code, Cursor or VS Code

Runs npx -y classic-mac-mcp on your machine. Read the scan report first; the gateway never runs local packages.

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

Add to Cursor

What the publisher says

From the Agentbridge repository's README, as published. We do not edit it. Read it on GitHub

AgentBridge

Let AI talk to your Classic Mac.

AgentBridge is a native Classic Mac OS application that lets AI agents (like Claude) interact with Mac OS 7–9 through structured commands and responses. It works on real hardware and emulators — no modifications to your Mac required.

Drop AgentBridge into a shared folder, launch it on your Mac, and an AI agent can list windows, open apps, type text, read the clipboard, browse files, and more — all through a simple text-based protocol.

How It Works

┌──────────────────────┐
│    Claude / AI Agent │
│         │            │
│    MCP Protocol      │
│         │            │
│    MCP Server (Node) │
│         │            │
│    Shared Folder I/O │
└────────┬─────────────┘
         │  reads/writes text files
         │
    ┌────┴──────────────────────────┐
    │  Shared Volume (NAS / AFP /   │
    │  SMB / emulator extfs)        │
    │                               │
    │  AgentBridge-MyMac/           │
    │  ├── inbox/   ← commands in   │
    │  ├── outbox/  ← responses out │
    │  ├── assets/  ← file staging  │
    │  └── heartbeat                │
    └────┬──────────────────────────┘
         │
┌────────┴─────────────────────────┐
│  Classic Mac OS 7 / 8 / 9        │
│                                  │
│  AgentBridge.app                 │
│  - Polls inbox for commands      │
│  - Executes via Mac Toolbox      │
│  - Writes responses to outbox    │
│  - Heartbeat every 2 seconds     │
└──────────────────────────────────┘

The transport is just a folder. How that folder is shared between the AI and the Mac is up to you:

NAS/file server (AFP or SMB) — multiple Macs and your modern computer all mount the same share
Emulator shared folder — BasiliskII and SheepShaver both support host directory sharing
Any other shared filesystem — if both sides can read and write files, it works

No SSH. No special drivers. No modifications to your Mac's system. AgentBridge is a regular application — launch it, quit it, done.

MCP Tools Reference

The MCP server exposes these tools to AI agents. If the fleet has only one target, the target parameter is optional on all tools.

System & Status

classicmaclisttargets** List all configured Classic Mac targets and their status (heartbeat alive/dead). No parameters.

classicmacping Health check — returns pong if AgentBridge is responding.

classicmacheartbeat Read the heartbeat file — shows uptime, front app, free memory, timestamp.

classicmacgetabout** System information — OS version, machine type, RAM, free memory, uptime.

Windows & Processes

classicmaclistwindows** Enumerate all visible windows across all applications. Returns window index, title, bounds (left,top,right,bottom), and front/back layer.

classicmacgetfrontwindow Get details about the frontmost window — title, bounds, owning app.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Agentbridge: common questions

Is Agentbridge MCP server safe?: Mostly: it is graded B (82/100). Read the Agentbridge safety report
How do I install Agentbridge?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Agentbridge need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Agentbridge maintained?: The last commit was 198 days ago (2026-04-20). The latest release is v1.0.2.
How does Agentbridge compare with other MCP servers?: safety score 82/100 (higher than 63% of 48,255 servers); tools 23 (the typical server has 7); tools that change things 4% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.