Assistants and MCP

Resources and notifications

MCP resources for granted tabs, page snapshots, downloads and browser events, and subscriptions that follow them.

This page is a first draft. It may change before the public beta.

Besides tools, the server offers resources. All are JSON.

URINameNeedsContents
arx://tabsGranted tabsreadThe granted tabs
arx://tabs/{tabID}Granted tabreadOne tab's inventory item
arx://tabs/{tabID}/snapshotPage snapshotpageContentA fresh semantic snapshot of the tab
arx://downloadsDownloadsdownloadsDownloads of whole-profile grants
arx://eventsBrowser eventsreadWhat happened in granted tabs, while the client subscribes

Subscriptions

Subscribe to a tab to follow its navigation and loading, or to arx://downloads to follow downloads. Arx sends notifications/resources/updated for the URI when it changes, and notifications/resources/list_changed when the set of granted tabs changes. A connection can hold up to 256 subscriptions.

Browser events

Subscribe to arx://events to hear about granted tabs without polling. Arx records events while the subscription lasts and sends notifications/resources/updated for arx://events when there are new ones. Read arx://events?after=N for the events after sequence number N; next is the newest.

EventWhen
tabOpened, tabClosedA granted tab appears or goes away, including by a grant change.
navigatedThe tab went to another address.
loadStarted, loadFinishedThe page started or finished loading.
pageErrorThe page failed to load; errorCode is Chromium's network error.
dialogOpenedThe page opened a JavaScript dialog; dialog says which kind.
permissionPromptThe page asked for a permission.
downloadsChangedSomething in the granted downloads changed (with downloads).
tabChangedThe tab changed in a way the others don't name, such as a reload. Arx looks every few seconds, so a load that starts and finishes in between shows up this way.

Each event has a sequence, the tabID and the tab's new revision, never the address, title or dialog text: read the tab's resource for those. Arx keeps the newest 200, and clears them when the client's grant changes.

Tool list changes

When the person changes a client's grant, the server sends notifications/tools/list_changed and the tool list shows only what the new grant covers. The client stays connected.