Context-aware web search MCP for agent harnesses — reads your project's AGENTS.md, compiles project context into agent-shaped queries, and searches through the You.com Search API.
Single tool 'search' has a well-structured schema with 4 parameters, all typed and described. Description is comprehensive (280+ chars) and explains context-aware behavior, multi-intent handling, and trace inspection. Input schema uses proper JSON Schema with minLength, maxLength, enum constraints. However, output schema is not documented in the visible code, the description mentions 'ranked results' and 'decomposition_request' but no formal response structure is defined. Error handling guidance is minimal. Tool naming is clear (verb_noun pattern). Overall solid for a single-tool server, but lacks output documentation and error recovery patterns.
Web search over the You.com Search API, tuned to this project's context. The server reads the project's context file (AGENTS.md, CLAUDE.md, GEMINI.md, Copilot/Cursor/Cline/Windsurf rules), merges it with any parameters you supply, compiles the query into lexical form (vocabulary injection, decision-ledger exclusions, source/freshness handling), and returns ranked results with an inspectable trace of exactly what ran. Multi-intent queries return a decomposition_request instead of results — split them and search per sub-query.
Output schema not documented. Description mentions 'ranked results' and 'decomposition_request' but no formal response structure (fields, types, example) is visible in code or docs.
Error handling lacks recovery guidance. No documented error categories (retryable, user-fixable, fatal) or actionable error messages. SanitizeError() strips details but doesn't guide LLM on next steps.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). 'search' is read-only but this is not declared in the tool definition, forcing LLMs to infer safety from description alone.
Result limits not enforced or documented. Description says 'ranked results' but no max result count, pagination parameters (limit, offset, cursor), or total count field is visible in schema.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients. Limits deployment and testing scenarios.