Field notes
Blog
What I learn running two MCP servers in production, and migrating other people's. No opinion pieces, only things you can check.
The 2026-07-28 spec, the seven changes in detailHow to build a custom MCP server in 2026 (2026-07-28 spec ready)
Most tutorials on building an MCP server were written for the 2025-11-25 revision. They open a session, run the handshake, keep state in memory, and call it done. On the 2026-07-28 spec, that code still answers old clients, but it is not what a new server should look like. This guide is for a team that wants a custom…
Read the postTasks: running long jobs without blowing the timeout
The Tasks extension moves to first class in the MCP 2026-07-28 revision. It solves a problem every server that does more than reading eventually hits: a tool call that runs too long. The problem A tool call is a request. A request has a timeout, often several, stacked: the client, your reverse proxy, your host, your…
Read the postWriting MCP tool descriptions the model actually understands
An MCP tool description is not documentation. It is your user interface. It is the only thing the model reads before deciding whether to call your tool, and it is often what the end user sees too. A vague description produces exactly the same effect as a badly labelled button: nobody clicks, or everybody clicks at the…
Read the postREST wrapper or agent-designed MCP server: why wrappers fail
The fastest way to ship an MCP server is to generate one tool per API endpoint. Your API has sixty endpoints, your server has sixty tools, done in a day. It is also the most reliable way to produce a server nobody keeps installed. Why it fails A REST API and an MCP server do not have the same user. An API serves a…
Read the postHow many MCP tools before the agent loses the thread
Nobody talks about this, and it is what decides how good your server feels to use. An MCP server is not judged on what it makes possible. It is judged on how often the agent picks the right tool on the first try. And that rate collapses well before you have finished exposing your API. Why the count matters The model…
Read the postWhere to list your MCP server in 2026: the official registry and the directories that matter
Building an MCP server is the easy part. Getting it found is the rest of the work, and it plays out across a handful of specific places. Here are the channels that matter, what each one asks for, and the order to do them in. Order matters more than the list The classic mistake is submitting everywhere at once, with a…
Read the postMCP Apps: a real interface in the chat, without an iframe
The MCP 2026-07-28 revision promotes MCP Apps to first class. The principle: a server can render an interface that appears inside the client, in the conversation, without an iframe and without the user leaving their chat. For a SaaS, this is the most interesting change in the revision, because it touches the product…
Read the postSetting up MCP compliance monitoring without a protocol team
Until 2026, keeping up with MCP was a sport. Revisions landed, features changed, and the only way not to be caught out was reading SEPs as they came. The 2026-07-28 revision changes that. It brings three governance pieces that make monitoring feasible without dedicating a role to it: a formal feature lifecycle, an…
Read the postDynamic Client Registration is deprecated: moving to Client ID Metadata Documents
OAuth 2.0 Dynamic Client Registration is formally deprecated by the MCP 2026-07-28 spec, in favour of Client ID Metadata Documents. It keeps working for backwards compatibility, but it has a date. If you operate an MCP server with OAuth, this is not urgent. It is still worth understanding now, because it solves a…
Read the postGetting accepted into the Claude connectors directory: the full submission
An MCP server listed nowhere is a server nobody installs. This is the part technical teams underestimate most: distribution work is separate from build work, and it has its own requirements. The Claude connectors directory is the most visible channel, and the most demanding. Here is what a submission that passes…
Read the postPrompt injection through MCP tools: the threat model your API never had
Your API had a simple threat model: an authenticated caller sends parameters, your code validates them, it responds. The caller was a program, doing what its developer wrote. An MCP server breaks that assumption. The caller is a model, and that model decides what to call based on a context containing text you do not…
Read the postThe 8 flaws found in almost every production MCP server
Auditing MCP servers turns up more or less the same holes every time. These are not exotic vulnerabilities. They are the predictable consequence of a server written like an API, and called by an agent. Here are the eight, in the order I run into them. One token that opens every tool The most widespread default. The…
Read the postOAuth for MCP servers: the three changes in 2026-07-28
The MCP 2026-07-28 revision does not only touch the transport. It also hardens authorization, with three changes driven by a simple observation: in practice, an MCP client talks to many servers, often dozens. That is not the deployment shape OAuth was originally designed around. The three changes are small in code and…
Read the postMCP Server Pricing in 2026: Build, Integration and Fixed-Price Costs
The question always arrives at the same moment: someone decided an MCP server is needed, and nobody knows what that costs. Here are honest ranges for the build, the integration, and the running cost everyone forgets, with the fixed prices I publish. Figures below come from the offers on accura.dev/en/mcp, read on 20…
Read the postSampling, roots and logging are deprecated: what replaces them
The 2026-07-28 revision moves three capabilities to deprecated: , and . In the SDKs they are marked obsolete, with pointers to their replacements. Before opening this work, one scheduling point that changes everything: the protocol now has a formal feature lifecycle. A deprecated feature stays functional for at least…
Read the postMcp-Method and Mcp-Name: routing MCP traffic without reading the body
This is the least dramatic change in the 2026-07-28 spec, and the highest return if you run the infrastructure. Two headers become mandatory on the Streamable HTTP transport: and . They mirror the JSON-RPC method and the name being called in the request body. A request calling the tool via now says so in its headers.…
Read the postThe initialize handshake is gone: what changes in your code
In every earlier revision of the Model Context Protocol, a connection began with a handshake. The client sent , the server answered with its capabilities, the client confirmed with , and from then on both sides knew who they were talking to. The 2026-07-28 revision removes that step. and are no longer required. There…
Read the postThe 12-point MCP migration audit checklist, before you touch any code
Most failed MCP migrations do not fail on the code. They fail because the team started writing before they knew what their server actually did. Here is the list I run before quoting a migration. It is designed to be executed in a day on a mid-sized server, without changing anything. A static audit does not prove…
Read the postStateless MCP: replacing Mcp-Session-Id with handles
The MCP 2026-07-28 spec removes sessions from the protocol layer. The header is gone from Streamable HTTP, and list endpoints no longer vary per connection. A server that needs to keep something between two calls now does it explicitly, with identifiers it mints itself that travel as ordinary tool arguments. The code…
Read the post-32002 becomes -32602: the change that breaks clients silently
This is the smallest change in the MCP 2026-07-28 spec, and the one that generates the most annoying tickets. MCP had introduced as a custom error code for a missing resource. JSON-RPC 2.0 already had for invalid params. The two overlapped. The new revision drops the duplicate and keeps the standard code. Why it hurts…
Read the postHow to migrate an MCP server to the 2026-07-28 spec
On 28 July 2026, the Model Context Protocol shipped its largest revision since launch. This is not a few new fields. The transport core was rewritten, three primitives are deprecated, authorization got stricter, and two extensions were promoted to first class. If you run an MCP server in production on 2025-11-25,…
Read the post
Got an MCP server to audit?
Five minutes to describe it. I reply within one business day with a first written diagnosis, free of charge.
Get my MCP server audited
