All notes
91
Tools, Part 2: Calling, Content Types, and Structured Output
Every shape a tool result can take: the five content types, structured output validated against a schema, and the difference between a failed tool and a failed protocol
2026-05-15
90Tools, Part 1: Discovery and the inputSchema Contract
What the model actually receives when it lists a server's tools, how the schema is built from a Go type, and why a tool's annotations cannot be trusted
2026-05-13
89Transport II, Streamable HTTP: One Endpoint, Two Directions
A single HTTP path carries the protocol. In 2025-11-25 a session id is optional. In 2026-07-28 it is gone.
2026-05-11
88Transport I, stdio: Two Pipes and a Subprocess
The simplest MCP transport, built by hand on both sides with no SDK, plus the stderr rule that silently breaks servers
2026-05-09
87Why Data MCPs Need Vector Search
Vector Search Without the Vector Database, Part 1
2026-05-08
86The Handshake: initialize, Capabilities, and Version Negotiation
The 2025-11-25 initialize exchange, hand-rolled in Go against a real server. Later revisions dropped it from the protocol core.
2026-05-07
85JSON-RPC 2.0: What Every MCP Message Looks Like
Three message shapes, one error object, and a hundred and fifty lines of Go that every MCP transport is built on
2026-05-05
84MCP Is a Protocol, Not a REST API
The same tool built both ways: what discovery, schemas, and the callback direction actually cost
2026-05-03
83Drive an MCP Server With Four JSON Messages
The Go SDK never prints the protocol. This post does.
2026-05-01
82The Pre-Commit Review Gate
AI on a Leash: Mechanical Self-Review for Claude Code
2026-04-22
81The Two Failure Modes That Break Your AI Data Agent
A Case Study in Agent Psychology
2026-02-26
80PostgreSQL to OpenSearch with PySpark on Kubernetes
Date-windowed ETL, idempotent upserts, and CronJob scheduling
2026-02-25
79GoReleaser with Cosign Signing and Syft SBOM
Signed Builds and Supply Chain Security for Go Projects
2026-02-11
78AI on a Leash: Complete Go Project Configuration
AI on a Leash for Go
2026-02-09
77Ralph's Uncle
AI on a Leash
2026-02-06
76Go's Constraints and Idioms Make AI Coding Better
From Vibe Coding to Vibe Engineering
2026-02-04
75MCP Is Flawed. Build With It Anyway.
Context has always been the hard problem. MCP forces you to solve it.
2026-01-20
74AI Data Lake Access with MCP and S3
Building composable MCP servers for object storage
2026-01-19
73AI Data Warehouse Access with MCP and Trino
Building composable MCP servers for enterprise data
2026-01-17
72kubefwd: Forward Kubernetes Services to Localhost by Name
One command, no configuration, automatic reconnection
2026-01-04
71kubefwd in 2026: Interactive TUI and Auto-Reconnect
The complete guide to kubefwd's new features
2026-01-04
70AI-Assisted Kubernetes Development with kubefwd
Let your AI assistant manage cluster connections
2026-01-04
69Apache NiFi: Dynamic HTTP Listeners with portpxy
Apache NiFi Part 5
2023-04-20
68Apache NiFi: JOLT Transformations Part 2
Apache NiFi Part 4
2023-02-15
67Apache NiFi: JOLT Transformations Part 1
Apache NiFi Part 3
2022-12-10
66Apache NiFi: Securing Your Data Flows
Apache NiFi Part 2
2022-10-05
65Apache NiFi: Production Kubernetes Deployment
Apache NiFi Part 1
2022-07-30
64Linear Algebra in Go: High-Performance Computing
Linear Algebra in Go Part 10
2022-05-25
63Linear Algebra in Go: Neural Network Foundations
Linear Algebra in Go Part 9
2022-03-20
62Linear Algebra in Go: PCA Implementation
Linear Algebra in Go Part 8
2022-01-15