Spotlight MCP

A Model Context Protocol server that exposes Spotlight to any AI client — so an agent can lint your API artifacts and work with rulesets conversationally. It runs the same @spotlight-rules/* engine as spotlight-cli, over stdio.

Tools

Related MCP server: APIMatic Validator MCP Server

Use it

npm install
npm start          # speaks MCP over stdio

Claude Desktop / any MCP client

Add to your client's MCP server config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "spotlight": {
      "command": "npx",
      "args": ["-y", "@spotlight-rules/spotlight-mcp"]
    }
  }
}

Then ask: "Lint this OpenAPI with Spotlight and tell me what to fix."

Part of the Spotlight suite

One engine (the CLI), one vocabulary (the spec + its rule tags): spec · cli · api (HTTP) · mcp (AI, this repo) · vscode · validator. Where spotlight-api is the HTTP surface, this is the AI surface.

Part of Spotlight Rules — a project of API Evangelist, maintained openly under API Commons. Apache-2.0.