TypeScript SDK for the Agent Application Protocol - provides client and server implementations for building agent-based applications with support for streaming, tool execution, and session management
This is an SDK/framework, not a production MCP server. The three tools shown are example implementations with minimal quality. web_fetch appears twice (likely a duplicate in the listing). Descriptions are extremely terse (16-34 chars, well below the 50-200 char baseline for LLM-optimized tools). Input schemas are present but lack parameter descriptions, only 'url' and 'expression' are named with minimal context. No output schemas documented. No error handling guidance. The tools are READ_ONLY, which is good, but the definitions lack the depth needed for reliable agent invocation.
Evaluate a mathematical expression
Fetch the text content of a URL
Fetch the text content of a URL
Descriptions are critically short (16-34 chars). Baseline is 50-200 chars for LLM-optimized tools. 'Fetch the text content of a URL' and 'Evaluate a mathematical expression' lack context on when to use, what to expect, and error cases.
Parameter descriptions are missing. The 'url' parameter in web_fetch has only 'URL to fetch' (12 chars). The 'expression' parameter in calculate has only 'Math expression to evaluate' (27 chars). LLMs cannot infer constraints (format, length, valid values) from names alone.
No output schemas documented. Callers cannot know what fields to expect from web_fetch (plain text? structured JSON?) or calculate (number? string? error object?). This forces LLMs to guess and wastes tokens on parsing.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2025-06-18+ | v2 |
No error handling guidance. If web_fetch hits a 404 or timeout, or calculate receives invalid syntax, there is no recovery hint. LLMs have no actionable next step.
Duplicate tool definition: web_fetch appears twice in the tool list with identical schemas. This suggests either a listing error or unintended duplication in the example server.