SlidesGPT AI PowerPoint Powered by ChatGPT API

[
  {
    "name": "create_slides",
    "title": "Create Slides",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Create one or more professional presentation slides. Pass a single slide in the array for one slide, or multiple slides for a full deck.\n\nUse when the user asks for slides, a presentation, or a deck. If the request is ambiguous about count, default to 2-3 slides.\n\nATTACHED PDFs / DOCUMENTS: Claude ingests user-attached files as document content blocks directly in the conversation. Read the document content from the conversation and pass the relevant material (topic, structure, key points) into this tool's slides argument — there is no separate file upload step.\n\nUSAGE NOTES:\n- Pass all slides for one request in a single call rather than multiple sequential calls.\n- To add to an existing presentation, pass the presentation_id from the previous response. For a new presentation, pass an empty string.\n- EDITING an existing slide: pass ONLY that slide, with its existing slidenum (from the previous response) and force_edit: true, plus the same presentation_id. This overwrites the slide in place. Do NOT resend the whole deck and do NOT omit force_edit, or a duplicate slide will be appended instead.\n\nIMAGES: Provide image_caption for every slide — describe the ideal slide image in 5-6 words (subject, setting, mood). Leave image_id empty; the system uses your caption to find the best matching photo.\n\nTHEMES: If the user asked for a specific theme, pass theme_id here rather than calling apply_theme separately afterwards.\n\nLAYOUT VARIETY (for multi-slide decks):\n- Use a variety of layouts across the deck, matching each layout to the slide's content.\n- Prefer \"title_and_two_columns\" (image layout) for the first content slide.\n- Use \"title_and_body\" for at most 1 slide (conclusion only), and avoid repeating the same layout on consecutive slides.\n- Use metric_rings only for percentage-based metrics (0-100).\n- Mix image slides, charts, timelines, grids, and text slides.\n\nLAYOUT OPTIONS (set layout for every slide):\n- \"title_and_two_columns\": Content with image alongside bullets (IMAGE LAYOUT)\n- \"title_and_two_to_four_columns_with_icons\": 2-4 key points with icons (good default)\n- \"title_and_body\": Single-column bullets (use sparingly — AT MOST 1 per deck, conclusion only)\n- \"title_and_subtitle\": Section divider or transition slide (title + subtitle only, minimal body)\n- \"image_full_width\": Full-width image with optional text below (IMAGE LAYOUT)\n- \"image_left_text_right\": Image on the left with bullet points on the right (IMAGE LAYOUT)\n- \"quadrant_grid\": EXACTLY 4 comparable items — SWOT, 2x2 matrices, pros/cons\n- \"data_table\": Structured comparisons in tabular format (key:value pairs in description)\n- \"timeline_horizontal\": Chronological events, milestones, or history (dates in point, short descriptions)\n- \"layered_pyramid\": Hierarchical structures with 3-6 levels (MUST include icon with fa- prefix per item)\n- \"phase_roadmap\": Project phases with milestones — point MUST use \"Period: Title\" format (e.g., \"Q1 2024: Launch\")\n- \"metric_rings\": KPIs, completion rates, market share (1-4 metrics, values 0-100 as percentages)\n\nCONTENT REQUIREMENTS:\n- 3-5 substantial bullet points per slide\n- Each bullet description: 2-4 lines with specific data, evidence, or actionable insights\n- Content should be PhD-level, detailed, and evidence-driven\n- Use FontAwesome 5.15 icons (e.g., fa-bolt, fa-chart-line, fa-lightbulb)\n- EVERY body item MUST include \"value\" (0-100) — enables chart rendering and layout switching\n\nLAYOUT-SPECIFIC FORMATTING:\n- quadrant_grid: EXACTLY 4 items. \"point\" under 15 chars, \"description\" under 80 chars\n- timeline_horizontal: Dates/years in \"point\" (max 15 chars). \"description\" max 50 chars\n- layered_pyramid: \"icon\" with fa- prefix REQUIRED (fa-star, fa-check, fa-rocket). 3-6 items\n- phase_roadmap: \"point\" = \"Period: Title\" (e.g., \"Q1 2024: Launch\"). Max 4 phases. \"description\" = milestones separated by \"; \"\n- metric_rings: 1-4 items. For part-of-whole metrics (market share), values sum to ~100. For standalone KPIs (NPS, satisfaction), each value stands alone\n- data_table: \"description\" should use structured key:value pairs\n\nSCHEMA: Use only the documented schema fields — do not invent custom properties like \"left_content\", \"right_content\", \"table\", \"rows\", or \"headers\". For tables, use the data_table layout with key:value pairs in body[].description.",
    "inputSchema": {
      "type": "object",
      "required": [
        "presentation_id",
        "slides"
      ],
      "properties": {
        "slides": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title"
            ],
            "properties": {
              "body": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "point",
                    "description",
                    "icon",
                    "value"
                  ],
                  "properties": {
                    "icon": {
                      "type": "string",
                      "description": "FontAwesome 5.15 icon name (e.g., 'lightbulb', 'chart-line', 'rocket'). REQUIRED for layered_pyramid (use fa- prefix: 'fa-star', 'fa-check')."
                    },
                    "point": {
                      "type": "string",
                      "description": "Main point (2-6 words). For timeline_horizontal: use dates/years (max 15 chars). For phase_roadmap: MUST use 'Period: Title' format (e.g., 'Q1 2024: Launch'). For quadrant_grid: keep under 15 chars."
                    },
                    "value": {
                      "type": "number",
                      "description": "REQUIRED for ALL layouts. Numeric value 0-100. For metric_rings: used directly for chart rendering (must be realistic percentages). For other layouts: preserved so users can switch layouts without losing data. For part-of-whole data (market share), values should sum to ~100."
                    },
                    "description": {
                      "type": "string",
                      "description": "Detailed explanation (2-4 lines). For timeline_horizontal: keep SHORT (max 50 chars). For quadrant_grid: max 80 chars. For phase_roadmap: milestones separated by '; '. For data_table: use key:value pairs. Otherwise include data, evidence, or insights."
                    }
                  }
                },
                "description": "Array of 3-5 substantial bullet points. EVERY item MUST include value (0-100). Follow layout-specific formatting rules from the tool description."
              },
              "title": {
                "type": "string",
                "description": "Slide title"
              },
              "layout": {
                "enum": [
                  "title_and_body",
                  "title_and_two_columns",
                  "title_and_two_to_four_columns_with_icons",
                  "title_and_subtitle",
                  "image_full_width",
                  "image_left_text_right",
                  "quadrant_grid",
                  "data_table",
                  "timeline_horizontal",
                  "layered_pyramid",
                  "phase_roadmap",
                  "metric_rings"
                ],
                "type": "string",
                "description": "REQUIRED. The visual layout for this slide. Choose the best fit for the content:\n- \"title_and_two_columns\": Content with image alongside bullets (IMAGE LAYOUT)\n- \"title_and_two_to_four_columns_with_icons\": 2-4 key points with icons\n- \"title_and_body\": Single-column bullets (use sparingly — max 1 per deck, for conclusion only)\n- \"title_and_subtitle\": Section divider or transition slide\n- \"image_full_width\": Full-width image with optional text below (IMAGE LAYOUT)\n- \"image_left_text_right\": Image on left, bullets on right (IMAGE LAYOUT)\n- \"quadrant_grid\": Exactly 4 items for SWOT, 2x2 matrices, pros/cons\n- \"data_table\": Structured comparisons in tabular format\n- \"timeline_horizontal\": Chronological events, milestones, or history\n- \"layered_pyramid\": Hierarchical structures (3-6 levels, include icon per item)\n- \"phase_roadmap\": Project phases with milestones (\"Period: Title\" format required)\n- \"metric_rings\": KPIs, percentages, market share (1-4 metrics, values 0-100)"
              },
              "image_id": {
                "type": "string",
                "default": "",
                "description": "Optional image ID. Leave empty to let the system pick an image."
              },
              "slidenum": {
                "type": "number",
                "description": "Slide number in sequence"
              },
              "subtitle": {
                "type": "string",
                "description": "Slide subtitle"
              },
              "talktrack": {
                "type": "string",
                "description": "Speaker notes for this slide"
              },
              "force_edit": {
                "type": "boolean",
                "description": "Set true to EDIT an existing slide: overwrite the slide at this slidenum in place instead of appending a new one. Required when modifying a slide already in the deck."
              },
              "image_caption": {
                "type": "string",
                "default": "",
                "description": "REQUIRED for every slide. Describe the ideal slide image in 8-10 words — specific subject, setting, and mood (e.g. 'ancient Roman Colosseum at golden hour dramatic sky'). Better captions produce more relevant images."
              },
              "custom_image_url": {
                "type": "string",
                "default": "",
                "description": "URL of a custom image (AI-generated via generate_image, or extracted from PDF via upload_files). Replaces stock photo when set. Must use an image layout."
              }
            }
          },
          "description": "Array of slide objects. Pass 1 slide for a single slide, or multiple for a full deck."
        },
        "theme_id": {
          "enum": [
            "copenhagen-light",
            "copenhagen-dark",
            "tokyo-light",
            "tokyo-dark",
            "paris-light",
            "paris-dark",
            "berlin-light",
            "berlin-dark",
            "new-york-light",
            "new-york-dark",
            "la-light",
            "la-dark",
            "zurich-light",
            "zurich-dark",
            "shanghai-light",
            "shanghai-dark",
            "cosmic-pulse-light",
            "cosmic-pulse-dark"
          ],
          "type": "string",
          "description": "Optional. If the user requested a specific theme upfront, pass it here and the slides will be rendered with that theme immediately — no separate apply_theme call needed."
        },
        "visual_set_id": {
          "type": "string",
          "default": "",
          "description": "If upload_files returned a visual_set_id, pass it here so the server can ensure all extracted visuals are included."
        },
        "presentation_id": {
          "type": "string",
          "default": "",
          "description": "ALWAYS include this field. Pass empty string '' on the very first call. For every subsequent call in the same conversation, pass the exact presentation_id returned by the previous create_slides response."
        }
      },
      "additionalProperties": false
    }
  },
  {
    "name": "apply_theme",
    "title": "Apply Theme",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Apply a visual theme to re-style the entire presentation.\n\nWHEN TO USE:\n- User says \"apply Tokyo Dark theme\", \"change theme to Paris\", etc.\n- User wants to customize the presentation appearance\n\nAVAILABLE THEMES (18 total):\n• Urban: copenhagen, tokyo, paris, berlin, new-york, la, zurich, shanghai (each has -light and -dark variants)\n• Gradient: cosmic-pulse-light/dark\n\nREQUIRES: presentation_id from previous slide creation. This re-renders all slides with the new theme.",
    "inputSchema": {
      "type": "object",
      "required": [
        "presentation_id",
        "theme_id"
      ],
      "properties": {
        "theme_id": {
          "enum": [
            "copenhagen-light",
            "copenhagen-dark",
            "tokyo-light",
            "tokyo-dark",
            "paris-light",
            "paris-dark",
            "berlin-light",
            "berlin-dark",
            "new-york-light",
            "new-york-dark",
            "la-light",
            "la-dark",
            "zurich-light",
            "zurich-dark",
            "shanghai-light",
            "shanghai-dark",
            "cosmic-pulse-light",
            "cosmic-pulse-dark"
          ],
          "type": "string",
          "description": "The theme ID to apply. Choose from: copenhagen-light/dark, tokyo-light/dark, paris-light/dark, berlin-light/dark, new-york-light/dark, la-light/dark, zurich-light/dark, shanghai-light/dark, cosmic-pulse-light/dark"
        },
        "presentation_id": {
          "type": "string",
          "description": "The presentation ID to apply the theme to. This is required and should be the ID returned from slide creation."
        }
      },
      "additionalProperties": false
    }
  }
]