Skip to content

components_v2_validate

Category: components_v2

Validate a Components V2 components array OFFLINE (no Discord API call). Catches 40-cap, nesting violations, accessory mismatches, MediaGallery range, Button missing custom_id/url.

iterate on a layout before sending. Saves round-trips for agents constructing complex cards.

FieldTypeRequiredDescription
componentsarrayyesComponents array (will be validated)

\{valid, issues:[\{path, code, message, fix_hint?\}]\}.

FieldTypeRequiredDescription
validbooleanyes
issuesarrayyes
PropertyValue
Read-onlyyes
Destructiveno
Idempotentyes
Open-worldno
Confirmation requiredno

packages/mcp-core/src/tools/components-v2/validate.ts