The server defines 2 tools with very similar names and responsibilities, creating composition violations. Both tools have partial schema definitions visible in the code, but descriptions are minimal (under 100 chars) and lack critical context about when to use each vs. the other. Parameter descriptions exist but are sparse. No output schema documentation is visible. The duplicate tool design (get_filing_sections vs get_filing_sections_artifact) violates the single-responsibility principle and forces LLMs to guess which to use. Input schemas show proper typing (string, array) but lack constraints like enums or patterns. No error handling guidance is documented.

• Merge get_filing_sections and get_filing_sections_artifact into a single tool with an optional 'output_format' parameter (enum: 'markdown' | 'artifact'). Or split them with clear semantic names: get_filing_sections_markdown vs get_filing_sections_embedded, with descriptions explaining the trade-off (local file vs inline reference).
• Expand tool descriptions to 150-250 characters explaining: What exact data is extracted? What format is returned? When would you use this vs alternatives? Example: 'Extract specified SEC filing sections (e.g. 1, 1A, 7) and return as formatted markdown. Use this for single sections; use batch_get_filings for multiple filings.'
• Document return schema explicitly. Specify: Does it return a string (markdown)? JSON object with {content, sections, metadata}? Include example structure in docstring.
• Add format specifications to parameters: CIK (10 digits, zero-padded), accession_number (regex: \d{10}-\d{2}-\d{6}), section_ids (enum or pattern matching SEC standard sections like '1', '1A', '1B', '2', etc.).
• Add error handling guidance: 'If filing not found or sections missing, the tool will return a 404-style error. Verify CIK and accession_number using search_company() and search_filings() first. Invalid section_ids will be listed in the error response.'
• Since these are READ_ONLY tools, explicitly document in the description: 'This tool does not modify filings. It retrieves and formats public SEC data. No permission checks required; data is publicly accessible.'