spotlight-mcp

Spotlight for AI clients — govern your APIs conversationally.

spotlight-mcp is a Model Context Protocol server that exposes Spotlight to any AI client. An agent can lint your API artifacts, list the rules, and validate rulesets — in conversation — running the same @spotlight-rules engine as the rest of the suite, over stdio.

Tools

lint_artifact	Lint an artifact (content, optional format/ruleset) → findings + counts
list_rulesets	Built-in rulesets and their rules
list_formats	Artifact formats Spotlight can lint
validate_ruleset	Structurally validate a ruleset

Add it to your AI client

For Claude Desktop (or any MCP client), add a server entry:

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

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