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.
| Artifact | MCP |
|---|---|
| Applies at (given) | $.capabilities |
| Severity | info — educational by default; raise to warn/error to enforce |
| Reference | https://spotlight-rules.com/spec/rules/mcp/capability-mcp-capabilities-not-empty/ |