Loading ToolBench
Servidor MCP local: RAG do contexto e evolucao do produto (planning, docs, diario, memoria)
Two tools with solid naming (verb_noun pattern) and comprehensive parameter schemas using Zod. Descriptions are detailed and domain-specific (Portuguese, product context). However, output schemas are not formally documented, responses are inferred from code comments and text construction. Error handling is present but generic. Parameter descriptions are strong, but the tool lacks explicit guidance on when to use search_context vs read_doc, and no recovery hints for common failure modes.
Lê um documento do índice direto do disco (sempre fresco). Passe o path retornado por search_context. Opcionalmente passe heading para ler só uma seção (match parcial, sem acentos). Documentos muito grandes são truncados com a lista de headings disponíveis.
Busca híbrida (BM25 + similaridade semântica) sobre TODO o contexto do produto: specs de planning (PRD/tech-spec/tasks), docs, diário de sessões, memória, mapas de arquitetura, notas do produto, cards/PRs do GitHub e o próprio código-fonte dos repos. USE ESTA TOOL ANTES de explorar arquivos manualmente ou lançar agentes de exploração — uma consulta aqui costuma achar de uma vez a spec, o card e o arquivo que implementam algo. Aceita tanto palavras-chave (blocklist fragmento) quanto a pergunta inteira (por que a AIH aparece duas vezes?) — a metade semântica cobre o caso em que você não sabe o termo exato. Filtre por source ('mapa' para arquitetura, 'code' para código, 'diario' para histórico de sessões, 'github' para cards/PRs).
Output schemas not formally documented. Responses are constructed as text with optional _meta.brain diagnostic field, but no structured schema is declared for LLM consumption. LLMs cannot plan downstream operations without knowing response structure.
No pagination support in search_context despite potentially returning many results (limit up to 30). Large result sets risk context window exhaustion. No next_cursor or offset mechanism documented.
Error messages are generic text responses ('Nenhum resultado', 'Query vazia') without recovery guidance. No actionable hints for LLM on what to try next (e.g., 'Try shorter terms', 'Remove filters', 'Use list_features').
Tool composition unclear: no explicit guidance on when to call search_context vs read_doc. Description mentions 'USE ESTA TOOL ANTES' but does not explain the complementary relationship or when read_doc is preferred.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint, idempotentHint) declared. Both tools are read-only and idempotent, but this is not signaled to the MCP client or LLM.