Skip to main content
Glama
Sign In
Varritech

mcp-stateless-starter

by Varritech
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Remote

Stateless MCP Server Starter (2026 Spec)

Production-ready Model Context Protocol server that scales horizontally on plain HTTP — no sticky sessions, no shared Redis, no deep packet inspection at the gateway. Aligned with the 2026-07-28 MCP Specification Release Candidate.

Why stateless

The 2025 MCP transport required sticky sessions and a shared session store to survive horizontal scale-out. The 2026 spec drops both. Any MCP request can land on any instance behind a round-robin load balancer.

This repo is the minimum example: an MCP server exposing two tools (echo, now) using the stateless HTTP transport, deployable to Vercel/Fly/Cloudflare Workers without changes.

Related MCP server: Streamable HTTP Python MCP Server Template

Stack

  • Node 22 + TypeScript

  • @modelcontextprotocol/sdk (HTTP transport)

  • Zero state — every request is self-contained

  • Routes on Mcp-Method header so reverse proxies can shard without parsing JSON-RPC

Quick start

npm install
npm run dev          # http://localhost:3000/mcp
npm run test:client  # runs against local server

Deploy

# Vercel
vercel deploy

# Fly.io
fly launch

# Cloudflare Workers
wrangler deploy

All three work because the server holds zero session state between requests.

What changed vs 2025 transport

2025 (SSE + sessionId)

2026 (stateless HTTP)

Mcp-Session-Id header required

No session header

Server holds session map

Server holds nothing

Sticky LB required

Round-robin LB works

tools/list re-requested per session

Cached client-side per ttlMs

SSE stream for server→client

Server-Sent Events optional, only for tasks primitive

File map

  • src/server.ts — Express server, single /mcp POST route

  • src/tools.ts — tool definitions (echo, now)

  • src/client.ts — example client that connects + calls a tool

  • vercel.json — zero-config Vercel deploy

  • Dockerfile — for Fly/Cloud Run

Resources

License

MIT — fork freely.

Built by Varritech. We turn AI prototypes into shipped products.

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Server Scaffold

    vjouenne76
    A
    license
    B
    quality
    D
    maintenance
    A basic starter project for building Model Context Protocol (MCP) servers that enables standardized interactions between AI systems and various data sources through secure, controlled tool implementations.
    2
    MIT

  • Streamable HTTP Python MCP

    ferrants
    F
    license
    Not graded
    quality
    D
    maintenance
    A starter template for building MCP servers in Python using the streamable HTTP transport protocol. Provides a foundation with the MCP Python SDK and example configuration to quickly develop custom MCP servers.
    2
    -

  • mcp-server-toolkit

    sarmakska
    A
    license
    Not graded
    quality
    D
    maintenance
    Production-ready MCP server starter with authentication, observability, and a plugin system for building and deploying MCP servers quickly.
    MIT