MCP Spectral

@mark-sivill

About MCP Spectral

Lints/Validates an OpenAPI specification

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "OpenAPI linting (Spectral)": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "marksivill/mcp-spectral"
      ]
    }
  }
}

Tools

lints OpenAPI specification

lints OpenAPI specification with Spectral ruleset

returns version of Spectral being used

Overview

What is MCP Spectral?

MCP Spectral is a Model Context Protocol (MCP) server that uses Spectral to lint OpenAPI specifications. It is designed for developers who want to validate and fix OpenAPI documents through large language model (LLM) tools such as Claude Desktop.

How to use MCP Spectral?

Install Docker and Claude Desktop, then add a Docker run command for marksivill/mcp-spectral to the claude_desktop_config.json file. Restart Claude Desktop to access three tools: lint_openapi, lint_openapi_with_ruleset, and spectral_version. Use natural language prompts to lint or build OpenAPI specs.

Key features of MCP Spectral

Lints OpenAPI specifications using Spectral
Lints OpenAPI specs with a custom Spectral ruleset
Returns the installed Spectral version
Runs inside a Docker container for easy setup
Integrates with Claude Desktop via MCP

Use cases of MCP Spectral

Validate an existing OpenAPI specification for errors
Iteratively fix errors found in an OpenAPI document
Build an OpenAPI specification from API documentation and revalidate
Enforce custom linting rules on generated OpenAPI specs

FAQ from MCP Spectral

What tools does MCP Spectral offer?

It provides three tools: lint_openapi, lint_openapi_with_ruleset, and spectral_version.

What are the prerequisites to run MCP Spectral?

You need Docker installed on your machine and a host MCP client such as Claude Desktop.

How do I install and configure MCP Spectral?

Add a Docker run entry for marksivill/mcp-spectral to your claude_desktop_config.json file, then restart Claude Desktop. The Docker image will be pulled automatically.

Can MCP Spectral be used with other LLM tools besides Claude Desktop?

Yes, but the setup instructions assume Claude Desktop; adjust the configuration for your tool accordingly.

Where can I find more details about MCP Spectral?

See the Docker Hub page (marksivill/mcp-spectral) and the Spectral documentation at stoplight.io/open-source/spectral.

Frequently asked questions

What tools does MCP Spectral offer?

It provides three tools: `lint_openapi`, `lint_openapi_with_ruleset`, and `spectral_version`.

What are the prerequisites to run MCP Spectral?

You need Docker installed on your machine and a host MCP client such as Claude Desktop.

How do I install and configure MCP Spectral?

Add a Docker run entry for `marksivill/mcp-spectral` to your `claude_desktop_config.json` file, then restart Claude Desktop. The Docker image will be pulled automatically.