Islands provides 6 tools with complete JSON schemas and basic descriptions. Tool naming follows verb_noun convention (islands_list, islands_search, islands_add_repo, islands_sync, islands_status, islands_remove). However, descriptions are terse (10-80 chars), parameter descriptions are minimal or absent, and output schemas are not documented. The schema for islands_search is well-formed with type constraints and defaults, but islands_list and islands_status lack parameter detail. Error handling and recovery guidance are not visible in the tool definitions. Risk annotations (READ_ONLY, WRITE, DESTRUCTIVE) are present but not formalized as tool annotations in the MCP protocol.

• Document output schemas for all tools. Example for islands_search: 'Returns {results: [{file: string, snippet: string, score: float, index: string}], total: int, next_cursor?: string}'.
• Expand tool descriptions to 100-200 characters. Example: 'islands_remove: Permanently delete an indexed repository and all associated vector embeddings and cached files. This action cannot be undone. Requires index_name in format provider/owner/repo.'
• Add descriptions to all parameters. For islands_status.index_name: 'Optional. Index name in format provider/owner/repo (e.g., github/torvalds/linux). If omitted, returns status of all indexes.'
• Formalize risk annotations using MCP tool annotations. Convert Risk: DESTRUCTIVE to destructiveHint: true in the Tool definition. Convert Risk: READ_ONLY to readOnlyHint: true.
• Add error handling guidance to tool descriptions. Example for islands_add_repo: 'Returns error if URL is invalid, repository is unreachable, or indexing fails. Errors include: invalid_url, repo_not_found, network_error, indexing_failed.'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry