Two tools with complete schemas and descriptions, but output documentation is missing and error handling lacks recovery guidance. talent_search has good parameter constraints (limit 1-25); profile_get is simpler but both lack documented return schemas. Descriptions are adequate (120-180 chars) but could better explain when to use each tool vs alternatives. No tool annotations present. Error responses return raw HTTP status + body text without actionable recovery steps.

• Document the output schema for talent_search: specify that results are an array of objects with fields like {slug, recruiterUrl, fitSummary, ...}. Include field types and whether any are optional.
• Document the output schema for profile_get: specify the structure of a Prompthaus literacy record (e.g. {slug, name, pathways, evidence, ...}).
• Add tool annotations: both tools should declare readOnlyHint: true and idempotentHint: true in their schema to signal safety to agents.
• Enhance error messages with recovery guidance. Instead of 'Talent search failed (404): ...', return 'No candidates found for role "<q>". Try: (1) broadening the role description, (2) removing the pathway filter, or (3) calling talent_search with a different role keyword.'
• Add a discovery tool or document how to list valid pathway IDs. Either expose a list_pathways tool or include a note in talent_search description: 'Valid pathways include: product-manager, ai-engineer, gtm-growth-engineer, finance-analyst, ... (call with pathway=null to see all).'