Your MCP Server Is Only as Good as Its Tool Descriptions
An MCP tool is not useful because it exists. It is useful when the agent understands when, why, and how to call it.
Notes written while doing the work.
Technical posts, product decisions, and honest observations, written while building, not after.
Filter notes by topic and month.
Clear filtersTopic
AI engineering
What AI features look like when regular people use them in real life.
How I Would Build an Agent-Readable Personal Hub From Scratch
Start with the data model, then expose the same truth through pages, APIs, MCP tools, and examples.
API vs MCP: When Should You Use Each?
Use the interface that matches who's reading, humans, software, or agents.