Capability MCP Capabilities Not Empty

capability-mcp-capabilities-not-empty

info experience: discoverability spec: capabilities

capabilities should not be empty.

capabilities should declare at least one of tools, resources, or prompts.

Rule definition

The full Spotlight rule — drop it into a ruleset (.spotlight.yaml / .spectral.yaml) and run it with any Spotlight tool.

capability-mcp-capabilities-not-empty:
  title: Capability MCP Capabilities Not Empty
  reference: https://spotlight-rules.com/spec/rules/mcp/capability-mcp-capabilities-not-empty/
  description: capabilities should declare at least one of tools, resources, or prompts.
  message: capabilities should not be empty.
  given: $.capabilities
  severity: info
  then:
    function: schema
    functionOptions:
      schema:
        type: object
        minProperties: 1
  tags:
    - format:mcp
    - spec:capabilities
    - experience:discoverability
  prompt: "You are editing a MCP document to satisfy the Spotlight API governance
    rule 'capability-mcp-capabilities-not-empty' (Capability MCP Capabilities
    Not Empty). Requirement: capabilities should declare at least one of tools,
    resources, or prompts. To fix: Adjust the targeted value so it conforms to
    the schema this rule requires. This rule is evaluated at the JSONPath
    `$.capabilities` — inspect every location it matches and correct only what
    violates the rule. Make the smallest change that satisfies the rule, leave
    all unrelated content, key order, comments, and formatting unchanged, and
    keep the document valid MCP. Return only the complete corrected document,
    with no commentary."
AI fix prompt — send this to Claude, Gemini, or ChatGPT with your artifact to auto-fix this rule
You are editing a MCP document to satisfy the Spotlight API governance rule 'capability-mcp-capabilities-not-empty' (Capability MCP Capabilities Not Empty). Requirement: capabilities should declare at least one of tools, resources, or prompts. To fix: Adjust the targeted value so it conforms to the schema this rule requires. This rule is evaluated at the JSONPath `$.capabilities` — inspect every location it matches and correct only what violates the rule. Make the smallest change that satisfies the rule, leave all unrelated content, key order, comments, and formatting unchanged, and keep the document valid MCP. Return only the complete corrected document, with no commentary.
ArtifactMCP
Applies at (given)$.capabilities
Severityinfo — educational by default; raise to warn/error to enforce
Referencehttps://spotlight-rules.com/spec/rules/mcp/capability-mcp-capabilities-not-empty/