MCP Spectral

@mark-sivill

Basic information

About MCP Spectral

Lints/Validates an OpenAPI specification

MCP Spectral 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"
      ]
    }
  }
}

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

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.

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.

Comments

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep