Connect Clawsmith to your coding agent. Ship products like crazy.Unlimited usage during betaGet API Key →
← Back to ideas
clawsmith.com/idea/mcp-stateless-spec-linter
IdeaCompetitivemcpdeveloper-toolingstatic-analysisLive

A static linter that audits MCP server code for 2026-07-28 stateless spec compliance and flags every breaking change before it ships

MCP server maintainers have no automated way to detect whether their server still uses patterns the 2026-07-28 stateless RC removed or deprecated. The RC is a breaking protocol shift: sessions are gone (Mcp-Session-Id header removed, SEP-2567), _meta fields must appear inline on requests (not stripped), three new HTTP headers are mandatory, error code -32002 maps to -32602, and three constructs are formally deprecated with a 12-month removal clock (SEP-2596). Every team that ships an MCP server must audit for all of these manually today. This tool is a CLI and CI-friendly static scanner that reads TypeScript and Python MCP server source files, traces handler registrations, and flags exactly which of these breaking or deprecation-category issues are present, with per-finding fix guidance that cites the spec section. It is not an interactive inspector (that is MCP Inspector, a different tool) and is not a generic linter (existing tools like mcp-lint validate tool schemas for cross-client compatibility, not protocol-level stateless-spec compliance). Revenue comes from a CI/team tier (per-seat or per-repo subscription) and a hosted check service where teams paste a repo URL and get a compliance report without a local install.

Demand Breakdown

HN
500

Gap Assessment

CompetitiveMultiple tools exist but differentiation opportunities remain

3 tools exist (MCP Inspector, mcp-lint, mcp-server-analyzer) but gaps remain: Not a static scanner; requires a running server; produces no machine-readable compliance report; does not flag stateless-spec breaking changes in source code before a server is deployed.; Schema-layer only; does not inspect session-usage patterns, _meta field placement, HTTP header mandates, error code mapping, or any of the 2026-07-28 stateless RC breaking changes..

Features8 agent-ready prompts

Session-usage detection
_meta field placement checker
HTTP header mandate checker
Error code mapping audit
Deprecation flag scanner
CI integration and machine-readable report output
TypeScript and Python SDK dual-language support
Per-finding fix guidance with spec citations

Competitive LandscapeFREE

ProductDoesMissing
MCP InspectorInteractive visual tool for testing and debugging MCP servers at runtime; connects to a live server and lets developers call tools and inspect responses manually.Not a static scanner; requires a running server; produces no machine-readable compliance report; does not flag stateless-spec breaking changes in source code before a server is deployed.
mcp-lintCLI linter with 13 rules that validates MCP server tool schemas for cross-client compatibility; checks tool name format, description length, input schema shape.Schema-layer only; does not inspect session-usage patterns, _meta field placement, HTTP header mandates, error code mapping, or any of the 2026-07-28 stateless RC breaking changes.
mcp-server-analyzerPython MCP server for running RUFF linting and Vulture dead code detection on Python codebases.General Python code quality tool exposed as an MCP server; has no awareness of MCP protocol spec compliance, session usage, or stateless RC requirements.

Leads4BUILDER

@esafak
@flakiness
@jackbatzner
@Ricky-G
4 people already want this

Sign in to unlock full access.