I Graded 36 Popular MCP Servers: A Third Fail Agent Usability

I graded 36 popular MCP servers on agent usability. A third got a D or F

I built mcpgrade to test 36 popular MCP servers and found that a third fail basic agent usability checks. Despite passing protocol compliance, many official servers from MongoDB, Notion, and GitHub lack critical parameter descriptions, causing models to hallucinate arguments or refuse tasks. The data reveals that agent reliability depends less on engineering specs and more on disciplined documentation practices that current tools ignore.