You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8a69357
Browse filesBrowse the repository at this point in the historyBrowse files
One read-only call returns a bounded summary of everything the server knows about a page: components, route, navigations, HTTP calls, errors, console, forms, signals, stores and queries. It reuses each full tool's formatter, so masking stays the same, and skips sections whose inspector is off.
Refs #372.
Ninety-six tools, grouped by inspector. Each one answers a question you would otherwise answer by clicking through the panel.
7
+
Ninety-seven tools, grouped by inspector. Each one answers a question you would otherwise answer by clicking through the panel.
8
8
</ngmd-hero>
9
9
10
10
# Tools
@@ -17,7 +17,7 @@ This page lists every tool the [MCP server](./mcp-server.md) exposes. Each group
17
17
18
18
Tool ids use a colon, as `pangular:get-routes`. MCP clients see them with an underscore, as `pangular_get-routes`. The tables below drop the `pangular:` prefix. The `read` tools are also registered on the page under the same names, for [browser agents](./browser-agents.md).
19
19
20
-
Each tool has a short title that clients show in their tool lists, and the `list-` and `inspect-` tools also send their answer as structured content. See [Titles and structured output](./mcp-server.md#titles-and-structured-output).
20
+
Each tool has a short title that clients show in their tool lists, and the `list-` and `inspect-` tools and `snapshot`also send their answer as structured content. See [Titles and structured output](./mcp-server.md#titles-and-structured-output).
21
21
22
22
### Source and live tools
23
23
@@ -37,7 +37,7 @@ Each tool reads from one of three places. The stdio server registers only the to
37
37
38
38
### The page argument
39
39
40
-
Most page tools take an optional `page` argument to pick a browser tab. It defaults to the most recent one. `dispatch-ngrx-action`, `set-component-property` and `set-signal` refuse to guess when more than one tab could take the action. `form-action` and `fill-form` take the tab from the form id instead (the part after `@`, as in `Checkout.form@ab12`). `highlight` and `inspect-component` search every tab without it, newest first, and `defer-blocks`, `for-blocks` and `hydration` list every tab. `inspect-providers`, `highlight`, `inspect-component`, `defer-blocks`, `for-blocks`and `hydration` also accept `pageId`. The tables below leave `page` out.
40
+
Most page tools take an optional `page` argument to pick a browser tab. It defaults to the most recent one. `dispatch-ngrx-action`, `set-component-property` and `set-signal` refuse to guess when more than one tab could take the action. `form-action` and `fill-form` take the tab from the form id instead (the part after `@`, as in `Checkout.form@ab12`). `highlight` and `inspect-component` search every tab without it, newest first, and `defer-blocks`, `for-blocks` and `hydration` list every tab. `inspect-providers`, `highlight`, `inspect-component`, `defer-blocks`, `for-blocks`, `hydration`and `snapshot` also accept `pageId`. The tables below leave `page` out.
41
41
42
42
If `page` names a tab that doesn't report that data, the tool answers `No page <id> is reporting ...` and lists the tabs that do, newest first. It never falls back to another tab. Without `page`, a class name or tag resolves on the most recent tab that has it, and `highlight` names the other tabs where it also matches.
The URL comes from the HTTP or router report. A page that sends neither (no router, and no [HTTP setup](../getting-started/express.md)) still shows the URL its component tree reports, which also stands in when the other reports are more than 15 seconds older. A tab in the background stops reporting until it is shown again, so its last report is marked `(background)`: an old time there means the data is the last known state, not that the page is gone.
53
53
54
+
### snapshot
55
+
56
+
Gives one page's full picture in one bounded markdown answer, for an agent that wants everything at once or a bug report. Reads: page. Each section comes from the tool named under its heading, with the same masking, so call that tool for the rest.
|`sections`| No | The sections to include, in the order above. Every section without it. |
75
+
|`limit`| No | Most items per section, 1 to 50 (default 10). |
76
+
|`maxChars`| No | Longest answer, 2,000 to 50,000 characters (default 20,000). |
77
+
78
+
Each section is also cut at 4,000 characters. When the answer reaches `maxChars`, it ends with a `Truncated` note that names the sections left out. A section whose inspector is off in `inspectors`, or whose tools are off in `agent.tools`, is listed under `Skipped`, and a section the page reported nothing for is listed as empty. The answer starts with the untrusted-data notice once, for every section.
79
+
54
80
### open-in-panel
55
81
56
82
Gives the user a link that opens the panel on one tab with one item selected, and switches the panels that are open to it. Reads: page. Use it to point the user at what you found.
0 commit comments