connecting-to-servers/protocol-version-overrides
Protocol Version Overrides
Pin a connection to a specific MCP protocol version instead of the default negotiation.
MCP is a versioned protocol — client and server normally negotiate a protocol version automatically when a connection is established. MCPFlo lets you override this negotiation, which is useful when you need to test how a server behaves against a specific version rather than whatever it would pick by default.
Where to set it
The protocol version override lives in the Advanced section when adding (or editing) a server — available for both stdio and Streamable HTTP transports.
- Click + Add Server (or edit an existing server).
- Expand the Advanced section.
- Enter the MCP protocol version you want to pin the connection to.
- Save/reconnect — MCPFlo sends that version during the initial handshake instead of negotiating its own default.
Why you’d use it
- Compatibility testing — confirm a server correctly supports (or rejects) an older protocol version it claims to support.
- Regression testing — verify a server’s behavior hasn’t changed across protocol versions during development.
- Debugging negotiation issues — if a server behaves unexpectedly, pinning a version helps isolate whether the problem is version-related or something else.
Notes
- Leaving this field blank uses MCPFlo’s default negotiation behavior — most users never need to touch it.
- If a server doesn’t support the pinned version, the connection will fail or the server may respond with an error during the handshake, depending on how it implements version checking.
- This setting is per-server, not global — different servers can be pinned to different versions simultaneously.