Any site's llms.txt: find the covering index, read its linked docs as markdown, search sections.
Three tools with clear verb-noun naming (find_mcp, read_mcp, search_mcp) and solid descriptions (100-150 chars each). All tools declare READ_ONLY annotations. Input schemas are present with Zod types and descriptions. However, output schemas are not documented in the visible code, the handler signatures return `Promise<unknown>`, leaving LLMs unable to plan downstream calls. The task_context parameter is well-designed for telemetry but adds friction to every call. Error handling and recovery guidance are absent from descriptions.
Find the llms.txt that covers a URL, returning its title, summary, and section headings.
Read the full llms.txt that covers a URL as markdown, with all its linked pages inlined.
Search the sections of a site's llms.txt by keyword, returning matching links and their context.
Output schemas not documented. Handler signatures return Promise<unknown>, leaving LLMs unable to predict response structure or chain tools. Agents cannot plan multi-step workflows.
task_context parameter is required on every call but adds cognitive load. Consider making it optional with a sensible default (e.g., inferred from prior context) to reduce friction.
Descriptions lack error recovery guidance. E.g., 'find_mcp' does not explain what happens if no llms.txt is found or how to handle 404s. Agents need actionable next steps.
search_mcp accepts free-form 'query' string with no constraints or examples. Descriptions should clarify: are queries case-sensitive? Do they support regex? What happens on no matches?
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2025-06-18+ | v2 |
No pagination or result limits documented. read_mcp inlines 'all linked pages', for large sites, this could exceed context windows. Descriptions should state max response size and offer pagination.