🔗 I lint-scanned 36 popular MCP servers. A third of them are failing your agent.

A significant issue emerges from a recent study involving 36 popular Model Context Protocol (MCP) servers: one-third are failing to meet compliance standards. Even compliance checks by spec may not indicate usability for agents, highlighting that issues often stem from descriptions, naming conventions, and schema design rather than the underlying protocol itself. Many poorly performing servers exhibited zero descriptions for parameters, underscoring an epidemic of undocumented parameters, which directly impacts agent reliability. A new tool, mcpgrade, was introduced, scoring servers on their documentation quality. Results reveal that well-documented servers lead to higher agent performance, while the majority of D/F rated servers suffer from poor usability caused by lack of clarity and detail in their parameters. This calls for a more disciplined approach to documentation when maintaining MCP servers, as compliance and usability represent separate challenges.