BlogServer developmentPosts tagged Server development.1 postsSearch postsSearchAllNotesChecklistGuideMCPMigrationRankingRegistryRemote serversSecurityServer developmentSmitheryStatisticsSyncTool descriptionsTransportsTroubleshootingNov 1, 2026NotesHow to write MCP tool descriptions (we graded 7,660 of them)We ran our A to F tool-description grader over every tool on file, 7,660 tools from 673 MCP servers. The median description is seven words. Here is what the data and the research say, and seven fixes that take an afternoon.11 min readRead post