| Filename | Latest commit message | Latest commit date |
|---|---|---|
* Tools: x-mcp-header annotation tooling + -32602 unknown-tool rendering (#1632) Card 9/10 of the SDK-v2 + New Spec stack. Adds SEP-2243 `x-mcp-header` tooling to the Tools tab and adjusts result rendering for SDK v2's unknown-tool behavior, and bumps the SDK to 2.0.0-beta.5. - **`core/json/xMcpHeader.ts`**: a faithful port of the SDK's (non-public) `scanXMcpHeaderDeclarations` — validates every SEP-2243 constraint (primitive types incl. `number`, RFC 9110 token, case-insensitive uniqueness, statically-reachable `properties`-only chain) and derives the mirrored `Mcp-Param-{Name}` params for a kept tool. - **Excluded tools**: the SDK silently drops tools with invalid annotations from `tools/list`. InspectorClient now re-lists the RAW (unfiltered) list and scans it to recompute the excluded set with reasons — gated to the modern non-stdio era (matching the SDK's gate), recomputed on every aggregate refresh, surfaced via a new `excludedToolsChange` event + `getExcludedTools()` and `useInspectorClient().excludedTools`. The Tools sidebar lists them struck-through under an "Excluded (SEP-2243)" divider with the reason on hover. - **Mirrored args**: ToolDetailPanel shows a "Mirrored request headers" section listing each arg → `Mcp-Param-{Name}` (with the browser-omits note). - **-32602 rendering**: SDK v2 rejects an unknown-tool call with `-32602` instead of an `isError` result, which previously rendered nothing. New ToolCallErrorPanel renders a thrown tool-call error, with a targeted "Unknown Tool" hint for `-32602`. Adds unit + Storybook + integration coverage (a real modern server with an invalid-header tool fixture) for every path. `npm run ci`-equivalent checks green. Closes #1632 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XNdjEPKLG637X8YmhDiEk5 * test-servers: x-mcp-header modern showcase config + preset (#1632) Register the `invalid_header_tool` fixture as a preset and add `xmcpheader-modern-http.json` — a modern HTTP showcase serving echo, a valid-header `get_weather`, and the invalid-header tool — so the Tools-tab x-mcp-header tooling (mirrored headers, excluded-tools surface, -32602 rendering) can be exercised manually. Documented in the README alongside the other per-SEP showcase configs. Smoke-tested end to end in the web client. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XNdjEPKLG637X8YmhDiEk5 * docs: add #1632 proof screenshots to pr-screenshots End-to-end web-client verification of the x-mcp-header Tools tooling against the modern showcase server: excluded-tools surface + reason, mirrored-headers section, and the -32602 unknown-tool error panel. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XNdjEPKLG637X8YmhDiEk5 * Respond to review: disambiguate -32602, doc/search nits (#1632) Addresses the review on PR #1735: 1. -32602 "Unknown Tool" mislabel: `-32602` is generic Invalid params, so a known tool called with bad arguments hit the same code and rendered under the definitive "Unknown Tool" heading. Replace `isUnknownToolError` with `classifyToolCallError(code, message)` → "unknown-tool" only when the message names it (not found / unknown tool / …), else "invalid-params" (new "Invalid Parameters" heading + schema hint), else "generic". 2. Double pagination walk: expand the `listAllTools` comment to document that the excluded-tools recompute is a deliberately un-cached second raw walk (doubles list round-trips on modern non-stdio, runs even on a cache-served aggregate) — accepted for a debugging tool, no-op on legacy/stdio. 3. Doc nit: `scanXMcpHeaderDeclarations` no longer claims to visit "$ref targets" — reworded to note `$ref` is never followed (refs resolve into the unreachable `$defs` body). 4. Search nit: the excluded-list filter now matches name AND title, matching the main tools filter. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XNdjEPKLG637X8YmhDiEk5 * Tighten unknown-tool matcher to be tool-scoped (#1632 re-review nit) The re-review noted the -32602 disambiguation was symmetric: broad markers ("does not exist", "unrecognized") could inversely mislabel a genuine invalid-params message (e.g. "property 'region' does not exist") as "Unknown Tool". Scope the not-found/does-not-exist family to require the word "tool" in the same clause (matching the SDK's "Tool <name> not found"); keep "unknown tool" / "no such tool" as standalone unambiguous markers. Adds a tool-less-"does not exist" test asserting it classifies as invalid-params. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XNdjEPKLG637X8YmhDiEk5 * Add trigger_invalid_params showcase tool + Invalid Parameters screenshot (#1632) Adds a `trigger_invalid_params` spec-error trigger to the modern showcase server: the injector answers its `tools/call` with a real `-32602 Invalid params` JSON-RPC error whose message does NOT name an unknown tool. This lets the "Invalid Parameters" branch of the tool-call error panel (added in the review response) be exercised live, distinct from the unknown-tool `-32602`. - `SPEC_ERROR_TRIGGERS` gains the `trigger_invalid_params` entry (HTTP 200, in-band -32602) + preset registration. - Enable `injectSpecErrors` on `xmcpheader-modern-http.json` and add the tool. - README + pr-screenshots README document it; adds the live "Invalid Parameters" proof screenshot. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XNdjEPKLG637X8YmhDiEk5 --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
| .. | ||
| logging-legacy-era.png | ||
| logging-modern-era-control.png | ||
| logging-modern-era-loglevel-stamp.png | ||
| logging-modern-server-setting.png | ||
| README.md | ||
| subscriptions-legacy-live-update.png | ||
| subscriptions-legacy-resources-subscribe.png | ||
| subscriptions-modern-header-badge.png | ||
| subscriptions-modern-listen-acknowledged.png | ||
| tasks-legacy-cancel-sticky.png | ||
| tasks-legacy-run-as-task.png | ||
| tasks-modern-completed.png | ||
| tasks-modern-connected.png | ||
| tasks-modern-input-completed.png | ||
| tasks-modern-input-required.png | ||
| tasks-modern-loop-cancelled.png | ||
| xmcpheader-excluded-reason.png | ||
| xmcpheader-excluded-tools.png | ||
| xmcpheader-invalid-params.png | ||
| xmcpheader-mirrored-headers.png | ||
| xmcpheader-unknown-tool.png | ||
x-mcp-header Tools tooling (#1632) — proof screenshots
End-to-end verification of the SEP-2243 x-mcp-header Tools tooling against a
real modern (2026-07-28) HTTP test server
(test-servers/configs/xmcpheader-modern-http.json on port 3120), driven in a
real browser through the web client's remote-proxy transport.
Connected with Protocol Era = Modern. invalid_header_tool is dropped from
tools/list by the SDK (its x-mcp-header annotation is invalid), so the
Inspector re-lists the raw list and surfaces it struck-through under an
"Excluded (SEP-2243)" divider — showing why a tool vanished rather than
silently omitting it.
Hovering the excluded tool shows the exact scan reason: the header name
"Bad Header" contains a space, so it is not a valid RFC 9110 token.
get_weather's detail panel shows the "Mirrored request headers (SEP-2243)"
section: its city argument mirrors to Mcp-Param-City, with the note that the
SDK omits Mcp-Param-* on the browser transport.
Calling a tool the server no longer recognizes rejects with -32602 (SDK v2)
instead of an isError result, and renders as an "Unknown Tool" error panel
with a targeted hint (reproduced by swapping the sessionless server to one
without echo while the cached list still showed it).
-32602 is the generic Invalid params code, so a known tool rejected for
bad arguments throws the same code as an unknown tool. The panel disambiguates
from the message: a -32602 that does not name an unknown tool renders under
"Invalid Parameters" (with a schema hint) rather than "Unknown Tool".
Triggered live via the trigger_invalid_params tool, which returns a real
-32602 JSON-RPC error whose message is not about a missing tool.
Tasks extension era fork (#1631) — proof screenshots
End-to-end verification of the Tasks era fork against two real test servers
(test-servers/configs/tasks-modern-http.json on port 3222 and
tasks-legacy-http.json on 3223), driven in a real browser through the web
client's remote-proxy transport.
Modern era (2026-07-28, io.modelcontextprotocol/tasks extension)
Connected with Protocol Era = Modern (MCP 2026-07-28). The Tasks tab
appears in the monitoring sidebar because the io.modelcontextprotocol/tasks
extension was negotiated (it is empty until a task runs).
Connected with Protocol Era = Modern (MCP 2026-07-28). The Tasks tab is
gated on the negotiated io.modelcontextprotocol/tasks extension (not
capabilities.tasks). Running modern_task with Run as task on issues a
tools/call that returns a CreateTaskResult (resultType: "task"), then polls
tasks/get (no tasks/list); the completed task inlines its result (no
blocking tasks/result) — shown both in the Results panel and the Tasks card.
modern_input_task moves to input_required: the tasks/get response's
inputRequests map (visible in the task's Full Task Object) carries an embedded
elicitation/create, surfaced through the same pending-request modal the MRTR
path uses — note the accurate wording "your answer is submitted via a
tasks/update request (SEP-2663), not a retry". Answering it sends
tasks/update with the inputResponses, and the next poll completes the
task:
Legacy era (2025-11-25, contrast — unchanged)
Connected with Protocol Era = Legacy. The Tasks tab is gated on
capabilities.tasks; simple_task is taskSupport: "required" so Run as
task is forced on. The legacy flow uses tasks/list to populate the list,
tasks/get to poll, and the blocking tasks/result to fetch the payload
({ "message": "Task completed: no message", "taskId": … }). Note the legacy-only
Logs tab (this server advertises logging), absent from the modern monitor
set.
Notes
- SDK v2 removed all tasks support and era-gates the
tasks/*spec methods out of the 2026-07-28 era on both the client (outbound) and server (inbound), and its codec rejects aresultType: "task"result outright. So the Inspector drives the extension itself: the task-creation frame is rewritten at the transport into aCallToolResultcarrying the handle (the trueresultType: "task"frame is still logged to the Protocol/Network tabs), andtasks/get/tasks/update/tasks/cancelride a raw-wire request channel that carries the full modern envelope and is consumed by the transport before the SDK Client sees it. The test server servestasks/*from an Express interceptor ahead of the SDK handler (the SDK's modern leg would answer them-32601). - On modern, task creation is server-directed (SEP-2663): the client declares
the extension once and any tool may return a task, so the Tools screen offers
Run as task for every tool on a modern connection (rather than gating on the
legacy per-tool
taskSupport).









