How GitHub, Stripe and Cloudflare design MCP servers: two tools, big context gap

ostwal · reddit · 2026-11-18

Analyzing public docs of GitHub, Stripe, Notion, Atlassian and Cloudflare MCP servers: most are thin wrappers over existing APIs. Stripe exposes four generic tools (search/details/read/write); Cloudflare covers 2,500+ endpoints with just search() and execute(). GitHub's one-tool-per-endpoint approach with 100 tools made agents worse. Generic tools solve tool count but not context — descriptions don't explain entity IDs, lookup order, or domain meaning. Context lives in server instructions, search→fetch→act flows, tool grouping, and return shapes; instructions are hints, not contracts. The author found no production server using MCP resources/prompts for context.

Original post →

More from coding & agent

coding & agent channel →