·9 min read
Seven MCP Server Design Mistakes (And the Fixes)
A server that works in the inspector and fails in practice usually fails for one of seven reasons. None of them are protocol bugs — they are interface decisions that only show up once a model, rather than a developer, is doing the calling.
·11 min read
Build an MCP Server in Python: A Complete Walkthrough
From an empty file to a server that Claude, Cursor and your own agent harness can all call. The code is short; the decisions that determine whether anyone can actually use it are the part worth slowing down for.
·8 min read
Tool Schemas Models Actually Call: The Description Is the Prompt
Most agent failures that look like reasoning failures are tool-selection failures. The model picked the wrong function, or invented arguments, or did not realise a tool applied. Almost all of it is fixable in the schema — and the schema is prompt engineering, not API plumbing.