Spotlight MCP
Provides tools for linting API artifacts, including linting an artifact, listing available rulesets and formats, and validating custom rulesets.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Spotlight MCP Lint this OpenAPI and tell me what to fix"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 an artifact ( |
| The built-in rulesets ( |
| The artifact formats Spotlight can lint |
| 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 stdioClaude 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 toolslint_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
Scored across 4 tools
Each tool has a clearly distinct purpose: linting artifacts, listing supported formats, listing available rulesets, and validating ruleset definitions. No ambiguity or overlap.
All tool names follow a consistent verb_noun pattern (e.g., lint_artifact, list_formats). Underscore separation and lowercase verbs are used uniformly.
Four tools cover the core functionality of a linter server (lint, discover formats, list rulesets, validate rulesets) without being overly sparse or excessive.
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
MCP server (stdio): lint OpenAPI specs with Spectral via the AgentForge API
Convert, lint and generate LLM tool schemas for OpenAI, Anthropic, Gemini and MCP
Research-backed lint + generation for agent context files (CLAUDE.md, AGENTS.md) + prompt enhancer.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Related MCP Servers
- AlicenseBqualityDmaintenanceA 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.761 npm90MIT
- AlicenseBqualityDmaintenanceEnables 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.17ISC
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- FlicenseAqualityCmaintenanceProvides 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-