Home / MCP tooling

mcp-tools-lint

Lint MCP tool schemas and annotations before clients reject them.

TypeScript · MIT · latest v0.1.0

What it is

Lint MCP tool schemas and annotations before clients reject them. Point it at a running MCP server (stdio or Streamable HTTP) or at a saved tools/list result, and it checks every tool against what Claude Code and other strict clients accept: JSON Schema 2020-12 only, no boolean schemas, required names that exist, and annotations that are present, camelCase and not self-contradictory. It prints text, JSON or SARIF, writes an RFC 6902 patch for the fixable findings, and ships as a GitHub Action.

Built alongside dev-mcp-servers.

Install

npx @basitalisandhu/mcp-tools-lint --help              # run without installing
npm install -g @basitalisandhu/mcp-tools-lint@0.1.1    # global CLI, installs the mcp-tools-lint command
npm install -D @basitalisandhu/mcp-tools-lint@0.1.1    # as a dev dependency of a server project

From the README; see the full README for every option.

Releases

Topics: ai-agents, claude-code, cli, developer-tools, github-actions, hacktoberfest, json-patch, json-schema, lint, linter, mcp, mcp-server, mcp-tools, model-context-protocol, npm, sarif, tool-annotations, typescript