start_grab_session
Starts a capability-keyed Raven grab bridge on loopback to proxy a local app, inject the grab overlay into HTML, and surface design and motion suggestions for the page.
Instructions
Start a capability-keyed Raven grab bridge on loopback. Proxy mode is the preferred zero-paste path: it serves a running local app with the overlay injected into HTML; the manual script tag remains available when needed. When proxying the designer's own local dev server, Grab's Motion tab finds motion for the page and builds playgrounds itself; pass profile and project when the project has a taste binding so those suggestions follow the designer's notes and earlier motion decisions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_grab_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Path to DESIGN.md to expose over /tokens. Optional when proxy_target is set — a minimal temp DESIGN.md is created automatically. Required (and must exist) when proxy_target is omitted. | |
| port | No | Optional port; defaults to an ephemeral loopback port | |
| role | No | Overlay role; consumer preserves the component-request flow, maintainer enables direct design-system component creation | consumer |
| profile | No | Taste profile for the Motion tab's suggestions. Pass with project, or omit both. | |
| project | No | Bound project for the Motion tab's suggestions. Pass with profile, or omit both. | |
| proxy_target | No | URL of a running local dev server; the bridge will serve that app with the grab overlay auto-injected into every HTML page — user opens the bridge URL, zero setup |