Debug both ends of MCP Apps — render your server's app in a Playwright browser with 7 automated diagnostics, 12 under --profile (npx mcp-app-debug <server-url>), or grade a HOST's MCP Apps conformance with a probe fixture server (npx mcp-app-debug host). Speaks the 2025-11-25 and stateless 2026-07-28 MCP revisions, and --aggregator reproduces the namespacing-gateway failure that breaks apps calling their tools by the bare name.
This is a debug/diagnostic tool, not a production agent tool server. The 4 tools have minimal descriptions (10-50 chars), no parameter descriptions, and schemas are either empty objects or single undescribed properties. Tool names are generic (probe, report, poke, forecast) without action verbs. The 'report' tool is explicitly marked 'Not for the model', it's an internal callback, not an agent-facing tool. No error handling guidance, no output schemas documented. This server is designed for MCP protocol conformance testing, not for LLM agent interaction.
Returns a forecast for a city.
Returns a poke (or an error, in tool-error scenario).
Renders the mcp-app-debug probe app, which grades this host's MCP Apps support. Call it with no arguments.
Called by the probe app to report what it observed. Not for the model.
No parameter descriptions anywhere. 'forecast' accepts 'city' with a default but no description of what city means, format, or constraints.
Tool descriptions are under 50 characters and lack context. 'probe' says 'Renders the mcp-app-debug probe app' but does not explain when to call it or what it returns. 'report' is explicitly marked 'Not for the model', should not be exposed as an agent tool.
Tool names lack action verbs. 'probe', 'report', 'poke', 'forecast' do not follow verb_noun convention (e.g., run_probe, submit_report, test_poke, get_forecast). LLMs cannot infer intent from these names.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |
No output schemas documented. Callers cannot know what fields to expect from probe, report, poke, or forecast results.