Example MCP servers demonstrating integration with LangChain, including Math and Text processing servers with multiple transport options (stdio and SSE)
This repository contains 13 tool definitions across multiple example servers, but they are duplicates of just 4 unique tools (add, multiply, magic_number, remove_vowels). All tools have basic descriptions (10-30 chars) and proper input schemas with typed parameters. However, descriptions are minimal and lack context about when/why to use each tool. No error handling guidance, no output schema documentation, and no tool annotations. The tools are trivial math/text operations suitable only for examples, not production use.
Add two numbers
Add two numbers
Add two numbers
Add two numbers
Return the magic number
Return the magic number
Return the magic number
Return the magic number
Descriptions are too brief (10-30 chars). Rubric baseline is 194 chars average; these lack context about when to use each tool, prerequisites, or return value semantics.
No output schema documentation. Tools return primitive types (int, str) but LLMs need explicit documentation of return structure, especially for tools that might return objects or lists.
No error handling or recovery guidance. Tools lack descriptions of failure modes, invalid inputs, or what the LLM should do if a call fails.
Tool 'magic_number' has ambiguous naming. Does not start with a verb (get_, return_, fetch_). Should be 'get_magic_number' to clarify intent.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
Multiply two numbers
Multiply two numbers
Multiply two numbers
Multiply two numbers
Remove vowels from the given text
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All tools are read-only but this is not declared in the schema, forcing LLMs to infer safety.