Skip to main content
Glama
Spotlight MCP

Spotlight MCP

by api-commons

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

Tool

What it does

lint_artifact

Lint an artifact (content, optional format, optional ruleset) → findings (code, message, severity, path) + counts

list_rulesets

The built-in rulesets (spotlight:oas, :asyncapi, :arazzo) and their rules

list_formats

The artifact formats Spotlight can lint

validate_ruleset

Structurally validate a ruleset (alias, object, or YAML/JSON string)

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.

Available Tools

4 tools
lint_artifactA

Lint an API artifact (OpenAPI, AsyncAPI, Arazzo, APIs.json, JSON Schema, …) with Spotlight and return governance findings (code, message, severity, path).

Inputs: content (required), format, ruleset.

list_formatsA

List the artifact formats Spotlight can lint.

Inputs: no named parameters.

list_rulesetsA

List the built-in Spotlight rulesets (spotlight:oas, spotlight:asyncapi, spotlight:arazzo) and the rules each contains.

Inputs: no named parameters.

validate_rulesetB

Structurally validate a Spotlight ruleset (alias, definition object, or YAML/JSON string) against the engine.

Inputs: ruleset.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: linting artifacts, listing supported formats, listing available rulesets, and validating ruleset definitions. No ambiguity or overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., lint_artifact, list_formats). Underscore separation and lowercase verbs are used uniformly.

    Tool Count5/5

    Four tools cover the core functionality of a linter server (lint, discover formats, list rulesets, validate rulesets) without being overly sparse or excessive.

    Completeness4/5

    The tool set covers the main use cases, though a tool to view a single rule's details or run lint with a custom ruleset might be missing, but these are minor gaps.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that loads multiple OpenAPI specifications and exposes them to LLM-powered IDE integrations, enabling AI to understand and work with your APIs directly in development tools like Cursor.
      7
      61 npm
      90
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables validation of OpenAPI 2.0 and 3.0 specifications in JSON or YAML format using APIMatic's comprehensive API validation service through the Model Context Protocol.
      1
      7
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Python code linting by integrating the Model Context Protocol with tools like pylint and the OpenAI API. It allows for dynamic tool discovery and uses LLMs to orchestrate tool selection and provide refined analysis of linting results.
      -
    • F
      license
      A
      quality
      C
      maintenance
      Provides OpenAPI validation and analysis tools to assist developers in building Model Context Protocol servers. It generates developer context and specific agent prompts based on API specifications to streamline the creation of agentic workflows.
      9
      -