MCP server exposing Telnix HTTP/HTTPS packet capture, interception, and modification capabilities to MCP clients via stdio protocol
Telnix MCP server has 29 tools with schemas and descriptions present, but quality is inconsistent. Most tool descriptions are adequate (50-150 chars), and input schemas are properly typed with JSON Schema. However, critical gaps exist: (1) descriptions lack actionable context for LLM selection, many are purely functional without explaining WHEN to use the tool or prerequisites; (2) error handling is minimal, tools return JSON but lack recovery guidance or categorization; (3) output schemas are undocumented, LLMs cannot predict response structure for chaining; (4) several tools combine multiple concerns (e.g., system_restart vs system_restart_as_admin, flow_modify handles both request and response); (5) parameter descriptions are sparse, many lack format/range guidance. The codebase shows defensive HTTP error handling and output truncation (good), but the tool interface itself is not LLM-optimized.
Add an auto-reply rule to automatically modify matching requests/responses
Delete an auto-reply rule
List all auto-reply rules
Clear all breakpoints
Set breakpoints to pause request/response at matching flows
Start a new packet capture session
Stop the current packet capture session
Install the Telnix root certificate for HTTPS decryption
Output schemas undocumented. LLMs cannot predict response structure (fields, types, pagination) for downstream tool chaining. Code shows output truncation but no schema definition visible.
Error handling lacks recovery guidance. Code returns JSON errors but descriptions do not explain what LLM should do next (retry, lookup, ask user). No error categorization (retryable vs fatal).
Tool descriptions lack actionable context. Most are purely functional ('Start a new packet capture session') without explaining WHEN to use, prerequisites, or dependencies. No hints for multi-step workflows.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | 2026-07-28+ | v2 |
Decode base64-encoded data
Parse and pretty-print JSON data
Decode URL-encoded data
Encode data to base64
Encode data to URL-encoded format
Delete a captured flow from the session
Get detailed information about a specific captured flow
Export captured flows to file (HAR, JSON, or cURL format)
Modify request or response of a captured flow (breakpoint-based interception)
Replay a captured flow (resend the request)
List captured HTTP/HTTPS flows with optional filtering and pagination
Disable system proxy settings
Enable system proxy settings
Delete a capture session
List all capture sessions
Switch to a different capture session
Get Telnix settings
Update Telnix settings
Quit the Telnix application and clear system proxy settings
Restart the Telnix backend service
Restart the Telnix backend service with administrator privileges (Windows only)
Parameter descriptions lack format/range guidance. E.g., 'match_expr' in breakpoint_set has no example syntax; 'offset' and 'limit' in flows_list lack min/max bounds. LLMs cannot validate inputs.
Multiple tools combine concerns. flow_modify handles both request and response modification; system_restart and system_restart_as_admin are near-duplicates. Splits would improve composability.