
OpenAPI Lint
Lint OpenAPI 3.x files for missing security, responses and docs, and inspect operations
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 2 days ago
About OpenAPI Lint
OpenAPI Lint is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
A single file is loaded from a path or passed inline, in JSON or YAML, then checked for security and completeness. Findings are sorted by severity with a rule ID and JSON Pointer path. Rules include http servers, missing or unused security schemes, operations without security or explicitly public, API keys in query strings, HTTP Basic notes, missing success or error responses, undescribed parameters, duplicate operationIds, unversioned paths and deprecated operations.
Beyond linting it lets an assistant explore the API: list operations with their effective security (public, or inherited-none when nothing applies), fetch one operation with path-level parameters merged and local references resolved, and ask for any rule to be explained with a fix. Rules can be suppressed individually.
Only local # references are resolved and nothing is fetched. Swagger 2.0 files are flagged rather than linted. It runs from a pinned Docker image over stdio with a read-only mount, reads files up to 5 MB, and sends no telemetry. MIT licensed.
Install
Run in a terminal
claude mcp add mcp-openapi-lint -- docker run -i --rm ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0Add to claude_desktop_config.json
{
"mcpServers": {
"mcp-openapi-lint": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-openapi-lint": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-openapi-lint": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-openapi-lint": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-openapi-lint": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0"
]
}
}
}Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- lint_openapi
- Lint an OpenAPI document and return findings with rule ID, path and message.
- list_operations
- List operations with tags, effective security, parameters and response codes.
- get_operation
- Return one operation in full with merged parameters and resolved local references.
- explain_rule
- Explain a rule's severity, what it detects and how to fix it.
What it does
- Security-focused rules
- Flags missing, undefined or weak security schemes and public operations.
- Completeness checks
- Finds missing responses, descriptions, operationIds and versioning.
- Operation listing
- Shows each operation with effective security and response codes.
- Rule explanations
- Explains severity, detection and fix for any rule.
- Suppressible findings
- Ignore chosen rules per run.
Good for
- Review an API spec before release
- Find operations that are unintentionally public
- List every endpoint with its auth requirement
- Understand why a rule fired and how to fix it
Pricing
Open source
MIT licensed; free
Prices change. Check basitalisandhu.github.io before you buy.
OpenAPI Lint FAQ
Which versions are supported?
OpenAPI 3.0 and 3.1; Swagger 2.0 is reported by the openapi-version rule rather than linted.
Does it call my API?
No. Findings describe the document, not the running API, and nothing is fetched.
How big can the file be?
Up to 5 MB.
Can I silence a rule?
Yes, with the ignore option.
Is OpenAPI Lint free?
Yes. OpenAPI Lint is open source, so you can use and self-host it for free.
How do I add OpenAPI Lint to Claude Code?
Run this command in your terminal: claude mcp add mcp-openapi-lint -- docker run -i --rm ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0
What are the best alternatives to OpenAPI Lint?
The closest alternatives to OpenAPI Lint are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to OpenAPI Lint

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools