MCP Transports

The Geoff MCP server supports two transport modes.

stdio (default)

The default and recommended transport. The server communicates over stdin/stdout using the MCP JSON-RPC protocol. This is what Claude Desktop, Cursor, and most MCP clients expect.
When to use: Always, unless you need remote access or a custom HTTP client.

streamable-HTTP

The HTTP transport allows the MCP server to be accessed over the network.
The server will expose an /mcp endpoint accepting MCP protocol messages.

Authentication

When using HTTP transport, you can optionally require a bearer token with GEOFF_MCP_HTTP_TOKEN.

Transport Selection

Logging

All logs go to stderr to avoid corrupting the stdio JSON-RPC stream. Control log level with GEOFF_MCP_LOG_LEVEL: