Repository navigation
Foxhand helper v0.5.0
WebMCP Controller is now Foxhand. WebMCP
is the name of a proposed standard for websites to give agents their own tools,
and this add-on is a different thing.
Upgrading
-
The add-on updates in place from addons.mozilla.org. Your settings and token stay.
-
Run the install command once more to get the renamed helper:
- macOS and Linux:
curl -fsSL https://hamb1y.github.io/foxhand/sh | sh - Windows (PowerShell):
irm https://hamb1y.github.io/foxhand/ps | iex
The running WebMCP Controller helper hands over to
foxhand-hostwithout a
Firefox restart, and the oldwebmcp-controllerfolder is removed shortly after. - macOS and Linux:
-
Your AI's MCP config keeps working. Copying it again gives you the shorter
http://localhost:8901/mcpURL. -
No new permissions. The wire protocol is unchanged, so a 0.4 add-on and a
0.5 helper (or the reverse) still work together.
Fixed
- Page dialogs no longer hang actions. A click that made the page show
alert(),confirm()orprompt()waited 30 seconds, failed, and left the
dialog up. While the AI acts, alerts are now acknowledged and confirms and
prompts are cancelled. The result lists what the page asked. To answer OK,
repeat the action withdialog: "accept"(andpromptTextfor a prompt). - Links that open a tab say which tab.
act_clickreturnsopenedTabs
fortarget="_blank"links andwindow.open. - Pages that render late are read in full.
snapshot_ax,page_textand
act_findwait up to 1.5 seconds for the page to stop changing. Before,
content drawn just after load was missing, such as GitHub's file list. - Iframes are visible. Same-origin iframes are in snapshots and can be
clicked and typed into. Cross-origin iframes are listed with a note. - URLs without
https://work.tab_create,tab_navigateand
window_createwithgithub.comopened a broken add-on page. They now add
https://(http://forlocalhost, IP addresses and.local/.test
hosts). - Sleeping tabs work. Page tools on a tab Firefox had unloaded failed with
"restricted page?". The tab is loaded first. history_searchsearches all of history. It only covered the last 24
hours unless you passedstartTime.- PDF tabs give a useful error. They say the page is in Firefox's PDF
viewer and suggestscreenshot. tab_closetakes one tab. PasstabId,tabIds, or neither for the
active tab.- Snapshots mark elements disabled by an
aria-disabledancestor.
New
- Setup page. It opens on install (and on the update from WebMCP
Controller) and walks through three steps: install the helper, connect your
AI, try it. Each step turns green by itself. - Shorter install commands, served from
hamb1y.github.io/foxhand. The old
releases/latest/download/install.*links keep working. localhostin configs. The helper listens on both127.0.0.1and
[::1], solocalhostconnects whichever address a client tries first.- Five languages. English, Spanish, French, German and Simplified
Chinese, following Firefox's language. Messages meant for the AI stay in
English. - Firefox orange. The add-on's accent color is now Firefox orange instead
of lime: buttons, the toolbar icon and badge, and the AI cursor's bubble and
click ripple. - "Formerly WebMCP Controller" shows under the name in the toolbar popup,
so the renamed add-on is easy to recognize.
macOS
- Apple silicon only runs signed code. The helper carries an ad-hoc
signature, and the installer re-signs it if that signature doesn't verify.
The installer never triggers a Gatekeeper prompt.
Tested
Every release now installs the helper with the one-line installers on real
machines (Linux x64 and ARM, macOS Apple silicon and Intel, Windows x64 and
ARM), then drives real Firefox through all 44 tools over MCP. A release is
only published when all six pass.
Install
Helper app for the Foxhand add-on (formerly WebMCP Controller).
Windows: open PowerShell and paste:
irm https://hamb1y.github.io/foxhand/ps | iexmacOS / Linux: open Terminal and paste:
curl -fsSL https://hamb1y.github.io/foxhand/sh | shAlready installed? Run the same command again to update: Firefox switches to the
new helper by itself within a few seconds.
Then click Retry in the add-on popup. Manual: download the file for your
system below and run it with install (Windows: double-click the .exe; macOS: run
xattr -c on it first). The webmcp-host-* files are the same programs under their old names.