MCP server for web search using Gemini with grounding
The server exposes a single tool 'search' with a moderately well-defined schema. The tool name is action-oriented (search) and the description is clear and substantive (114 chars). However, the parameter descriptions contain example values (an LLM anti-pattern), and there is no documented output schema. The tool performs read-only web search via Gemini Grounded Search. Parameter validation is present in the handler code but not in the schema itself (no min/max for max_token). Overall, this is a functional definition with room for improvement in parameter constraints and output documentation.
Searches the web using Gemini Grounded Search. Expect more accurate results by searching in a natural language question format rather than by keywords.
Parameter 'question' description includes a full example value in brackets, which LLMs tend to reuse literally. Formal constraints (enums, patterns, length limits) should replace example values.
No documented output schema. Tool returns JSON via mcp.NewToolResultText(jsonResponse), but the response structure is opaque to callers. An LLM cannot anticipate what fields to expect or plan downstream operations.
Parameter 'max_token' is typed as 'number' with no minimum/maximum bounds stated in the description. Unbounded numeric parameters let LLMs pass absurd values (negative, 1M+) that may break the Gemini API or cause timeouts.
Parameter 'thinking_level' description lacks context on when to use each level or what impact each has on latency/cost. LLMs cannot reason about trade-offs without explicit guidance.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 58 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 48 | - | v1 |
Tool description states 'Expect more accurate results by searching in a natural language question format' but does not document the expected structure or limits of the returned JSON. Agents cannot plan multi-step workflows without knowing output format.