MCP server that performs web search using Google Search (via Vertex AI) to find information on the internet and returns synthesized answers with sources.
Single tool 'web_search' has clear naming and an explicit input schema, but the implementation reveals significant gaps in parameter documentation, output schema definition, and error handling guidance. The tool description is adequate (108 chars, within the 10-1024 range) but lacks context on when to use it vs alternatives, prerequisites, or recovery paths. The input schema is present and properly typed (query: string) but the parameter description is minimal and lacks format/constraint guidance. Output schema is implicit in the code (returns text content) but not formally documented in the tool registration. No error handling guidance is provided, the tool could fail gracefully or catastrophically, but agents have no recovery hints.
Performs web search using Google Search to find information on the internet and returns synthesized answers with sources.
Output schema not documented. Tool returns text content but agents cannot infer the structure, presence of sources, or downstream chaining needs.
Parameter description lacks constraints and format guidance. 'query' has description 'Your question or search query to find information on the web.' but does not specify length limits, required format, or examples of what works well.
Tool description lacks recovery guidance and disambiguation. Does not explain when to use web_search vs alternatives, prerequisites (e.g., API keys), or how to handle no-results cases.
No explicit error handling guidance. Code returns 'No search results or information found for query' on empty response, but agents are not told this is a retryable, user-fixable, or terminal state.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 61 | 2026-07-28+ | v2 |
| 2026-03-09 | D | 59 | - | v1 |
Google GenAI API credentials (PROJECT env var) injected via environment; no documented permission scopes or audit trail. Tool description does not declare required permissions (e.g., 'search:web').