alt.hn

7/22/2026 at 5:51:50 AM

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

https://tengli.dev/posts/mcp-servers-failing-agents.html

by tengbyte

7/22/2026 at 11:39:45 AM

> well-documented big catalogs are possible; they're just rare

They’re not that rare, it’s just that flat big catalogs don’t work well.

The most common failure mode for MCP server design is mapping MCP tools to system APIs. This results in a tool to list files, a tool to rename a file, a tool to copy a file, etc.

You can have 100 “tools”, you just need to define 10-12 areas (actual tools in the MCP model) and actions within each one. It creates a hierarchy that models can dive into when needed and avoid context clutter when that area is not needed.

So instead of 15 tools for file operations you have a single “file” tool, with actions like list, copy, rename, etc.

Single biggest arch requirement for any MCP server (well, any that has more than a handful of operations).

by brookst

7/22/2026 at 10:21:32 AM

JSON and CSV [and a massive amount of custom-made spaghetti code] gave the impression that semantics was totally unnecessary in dataflows. Now that we live in a world where dataflows build themselves, we will need a description language that is much more robust. Probably generated from chatbot interactions, but formally defining how the consumer can discover content and mix them.

by lolive

7/22/2026 at 8:52:21 AM

Somewhat ironically the link to your results table is broken

by codeonline

7/22/2026 at 9:39:36 AM

Remove the ] from then end

by nemoniac

7/22/2026 at 12:23:19 PM

This is stupid analysis. Complaining without nuance about "D004 - parameter has no description" suggests the article was written by an AI agent, because some parameters simply don't need any description. Prime example is "url" parameter explicitly mentioned in the article - unless there are multiple possible url parameters, adding the description just bloats context.

by Hitton

7/22/2026 at 2:38:28 PM

I'm not going to standardize an MCP server. I come from designing REST API's and the leniency of Python. In comparison to other frameworks, MCP is relatively new and there's valid skepticism because of Anthropic's proprietary schemes. It sounds like AI companies are gatekeeping MCP servers, based on definitions they made up, and can just have their goons go around purity testing them.

by kittikitti

7/22/2026 at 11:51:19 AM

Be warned, AI Slop ahead

by crefiz

7/22/2026 at 12:15:41 PM

Bro this is just slop.

by d1l

7/22/2026 at 2:00:05 PM

[flagged]

by luciana1u

7/22/2026 at 4:12:59 PM

[dead]

by graphsmith

7/22/2026 at 7:15:42 AM

[flagged]

by tengbyte

7/22/2026 at 11:11:32 AM

[flagged]

by melembre

7/22/2026 at 11:58:25 AM

[flagged]

by arthiarumugam18

7/22/2026 at 11:27:09 AM

[flagged]

by edifierxuhao