Skip to content
MCP server

OpenAPI Lint

Lint OpenAPI 3.x files for missing security, responses and docs, and inspect operations

Runs locallyStatus and history
Install
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.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-openapi-lint": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-openapi-lint": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-openapi-lint:0.3.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools