components_v2_build_media_gallery

Components v2 Read only

Build a Components V2 MediaGallery (type 12) - 1-10 media items.

MCP call example

{
  "name": "components_v2_build_media_gallery",
  "arguments": {
    "items": [
      {
        "url": "https://example.com/resource"
      }
    ]
  }
}

Input

Field	Type	Required	Constraints	Description
items	array<object>	yes	min items: 1; max items: 10	1-10 media items

Complete input JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "description": {
            "type": "string",
            "maxLength": 1024
          },
          "spoiler": {
            "type": "boolean"
          }
        },
        "required": [
          "url"
        ]
      },
      "description": "1-10 media items"
    }
  },
  "required": [
    "items"
  ]
}

Returns

{component} - MediaGallery JSON node.

Example structured result

{
  "component": {
    "type": 12,
    "items": [
      {
        "media": {
          "url": "https://example.com/image.png"
        }
      }
    ]
  }
}

Output schema

Field	Type	Required	Constraints	Description
component	unknown	yes

Complete output JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "component": {}
  },
  "required": [
    "component"
  ],
  "additionalProperties": false
}

Annotations

Property	Value
Read-only	yes
Destructive	no
Idempotent	yes
Open-world	no
Confirmation required	no

Access and common errors

• The components_v2 category must be enabled by MCP_CATEGORIES when an allowlist is set.
• This tool is local-only and does not call Discord. Schema or domain validation can still reject malformed input.

Source

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

Related tools

• components_v2_build_container
• components_v2_build_section
• components_v2_edit
• components_v2_preview