HireProof MCP server has 4 tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. All tools have descriptions (10-20 chars baseline met), but lack depth for LLM decision-making. Parameter descriptions are minimal or absent. No error handling guidance, no output schemas documented, no tool annotations. Naming is reasonable (verb_noun pattern: search_*, news_*, jobs_*, local_*) but descriptions are too brief to guide LLM selection effectively. No evidence of pagination, result limits, or chaining IDs in responses.

• Expand tool descriptions to 100-150 chars. For each tool, state: (1) What it does, (2) When to use it vs similar tools, (3) What it returns. Example: 'search_company: Verifies company legitimacy by checking official website, LinkedIn, domain registration, and business records. Use this FIRST to confirm company exists before checking news or salary benchmarks. Returns company name, website, LinkedIn URL, registration status, and founding year.'
• Add enum constraints to parameters. For jobs_compare.level, define: enum=['intern', 'junior', 'mid', 'senior', 'lead', 'executive']. For news_check.keywords, document: 'array of 1-5 strings; common values: scam, fraud, lawsuit, review, complaint'.
• Document output schemas for each tool. Example for search_company: '{type: object, properties: {company_name: string, website: string, linkedin_url: string, domain_registered: boolean, registration_year: number, business_status: enum[active|inactive|dissolved]}, required: [company_name, business_status]}'.
• Add error handling guidance. Example: 'If company not found, return {found: false, suggestions: [similar_company_names]}. If news unavailable, return {news_available: false, reason: "no_recent_articles", retry_after_hours: 24}'.
• Add pagination to jobs_compare. Include parameters: limit (1-50, default 20), offset (default 0). Return: {results: [...], total_count: number, has_more: boolean}. Document in description: 'Returns up to 20 comparable jobs per call; use offset to paginate.'