Transports

stdio for dev, Streamable HTTP for production, and capability stripping.

OpenAIOpen in ChatGPTAnthropicOpen in Claude

stdio

Default for bitmcp dev. One process, one client pipe. Best for Claude Desktop, VS Code, and Cursor during development.

pnpm dev

Streamable HTTP

Used for bitmcp start and optional dev:

bitmcp dev --http
pnpm start

Defaults:

  • Host: 127.0.0.1
  • Port: 3000
  • Path: /mcp

The path match is exact. /foo/mcp does not satisfy /mcp.

Override with --port or environment variables. GET /health returns { ok: true }.

Deploy the same dist/server.js on Vercel or Cloudflare. See Deploy.

Per-request factory

HTTP mode registers tools on every request. UI metadata is stripped when the client cannot render Apps. Text and MRTR always work.

Protocol version

bitmcp targets MCP Apps protocol 2026-07-28 only.

Not supported in v1

  • HTTP+SSE dual transport
  • Session middleware
  • Custom sticky routing

Use handles and explicit arguments instead.

PreviousHandlesNextCLI