FofaMap MCP server demonstrates moderately strong definition quality with consistent naming conventions and tool annotations, but suffers from incomplete parameter descriptions and missing output schema documentation. All 10 tools follow verb_noun naming patterns (fofa_* prefix). Tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) are properly declared for all tools. However, parameter descriptions are sparse or missing in several tools, and output schemas are not explicitly documented in the visible code. The server provides clear descriptions for most tools (average ~80 chars), meeting baseline expectations, but parameter-level documentation is inconsistent.

• Add explicit output schema documentation to each tool. Example for fofa_search: 'Returns SearchToolResult with fields: summary (str), query (str), fields (list[str]), records (list[dict]), total (int|null), next_cursor (str|null), consumed (float|null). Use next_cursor with fofa_search_next for pagination.'
• Document all parameters fully, including type, constraint, and format. Example for fofa_host_profile: 'host: IP address or DNS name (string, required). detail: Include host details (boolean, default true).'
• Add error handling hints to tool descriptions. Example: 'Returns error if query syntax is invalid, call fofa_validate_query first. Returns quota error if account limit exceeded, call fofa_account to check remaining quota.'
• Include tool dependency guidance in individual tool descriptions. Example for fofa_search: 'If searching by product/OA/VPN, call fofa_rules first to get correct app= name.'
• Document pagination behavior for tools returning multiple records. Example: 'Results paginated via cursor. Default limit 100, max 10000. Use next_cursor in fofa_search_next for continuation. Large queries may require multiple calls.'
• Add enum constraints for bounded parameter values. fofa_search 'size' param should document valid range (1 - 10000) with enum if only certain values are typical.
• Document field selection guidance for fofa_search 'fields' parameter. Explain default fields used when omitted, and reference fofa_fields for available options.