This server has solid tool naming and clear descriptions. All 5 tools follow verb_noun conventions (search_, get_, compare_). Input schemas are properly typed with JSON Schema. However, there are gaps in output schema documentation and parameter descriptions lack sufficient detail about constraints and formats. Error handling is basic. Tool descriptions are well-structured (100-200 chars, hitting the target range) but could include more guidance on when to use vs. similar tools. Parameters mostly have descriptions but lack constraints (min/max, regex patterns, examples). Annotation hints are present but underdocumented. The server implements pattern:tool, pattern:tool-description, and pattern:constrained-input partially, but misses pattern:response-shaper, pattern:tool-chain awareness, and pattern:recovery-guide.

• Document output schemas for all tools. For search_advertisers, formally define: { advertisers: [{id: string, name: string, verificationStatus: 'VERIFIED'|'NOT_VERIFIED'|..., totalAds: number, region: string}], total: number, nextCursor?: string }. Include in tool descriptions or a separate schema doc.
• Add parameter constraints to input schemas. For 'limit', set {"type": "number", "minimum": 1, "maximum": 100, "default": 20}. For 'region', use enum: ["US", "IN", "GB", ...]. Update descriptions to reference constraints: 'Maximum number of ads to return (1 - 100, default 20).'
• Enhance error responses with recovery guidance. Instead of {"success": false, "error": "Invalid advertiser ID"}, return {"success": false, "error": "Invalid advertiser ID 'xyz123'. Try search_advertisers() to find valid IDs.", "errorType": "INVALID_INPUT", "retryable": false}. Document error types (INVALID_INPUT, NOT_FOUND, RATE_LIMITED, NETWORK_ERROR) in the server description.
• Add explicit pagination support. Modify get_advertiser_ads and search_advertisers to accept 'offset' or 'page' parameters and return {"items": [...], "total": number, "nextOffset": number}. Document in descriptions: 'Use offset=0, limit=20 for first 20 results; then offset=20 for next batch.'
• Clarify tool chaining in descriptions. For search_advertisers, add: 'Returns advertiser IDs required by get_advertiser_ads, get_ad_details, and get_advertiser_profile.' For get_advertiser_ads, add: 'Returns creative IDs for use with get_ad_details.'
• Add dependency hints to descriptions. For get_ad_details, prepend: 'Requires a valid advertiserID (from search_advertisers or get_advertiser_profile) and creativeId (from get_advertiser_ads).'