Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SLIDESPEAK_API_KEY | Yes | Your Slidespeak API key obtained from https://slidespeak.co/slidespeak-api/ |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_available_templates | Get all available presentation templates. |
| get_me | Get details about the current API key (user_name and remaining credits). |
| generate_powerpoint | Generate a PowerPoint or PDF presentation based on text, length, and template.
Supports optional settings (language, tone, verbosity, images, structure, etc.).
Waits up to a configured time for the result.
Parameters:
Required:
- plain_text (str): The topic to generate a presentation about
- length (int): The number of slides
- template (str): Template name or ID
Optional:
- document_uuids (list[str]): UUIDs of uploaded documents to use
- language (str): Language code (default: 'ORIGINAL')
- fetch_images (bool): Include stock images (default: True)
- use_document_images (bool): Include images from documents (default: False)
- tone (str): Text tone - 'default', 'casual', 'professional', 'funny', 'educational', 'sales_pitch' (default: 'default')
- verbosity (str): Text length - 'concise', 'standard', 'text-heavy' (default: 'standard')
- custom_user_instructions (str): Custom generation instructions
- include_cover (bool): Include cover slide (default: True)
- include_table_of_contents (bool): Include TOC slides (default: True)
- add_speaker_notes (bool): Add speaker notes (default: False)
- use_general_knowledge (bool): Expand with related info (default: False)
- use_wording_from_document (bool): Use document wording (default: False)
- response_format (str): 'powerpoint' or 'pdf' (default: 'powerpoint')
- use_branding_logo (bool): Include brand logo (default: False)
- use_branding_fonts (bool): Apply brand fonts (default: False)
- use_branding_color (bool): Apply brand colors (default: False)
- branding_logo (str): Custom logo URL
- branding_fonts (dict): The object of brand fonts to be used in the slides |
| generate_slide_by_slide | Generate a PowerPoint presentation using Slide-by-Slide input.
Parameters
- template (string): The name of the template or the ID of a custom template. See the custom templates section for more information.
- language (string, optional): Language code like 'ENGLISH' or 'ORIGINAL'.
- include_cover (bool, optional): Whether to include a cover slide in addition to the specified slides.
- include_table_of_contents (bool, optional): Whether to include the ‘table of contents’ slides.
- slides (list[dict]): A list of slides, each defined as a dictionary with the following keys:
- title (string): The title of the slide.
- layout (string): The layout type for the slide. See available layout options below.
- item_amount (integer): Number of items for the slide (must match the layout constraints).
- content (string): The content that will be used for the slide.
Available Layouts
- items: 1-5 items
- steps: 3-5 items
- summary: 1-5 items
- comparison: exactly 2 items
- big-number: 1-5 items
- milestone: 3-5 items
- pestel: exactly 6 items
- swot: exactly 4 items
- pyramid: 1-5 items
- timeline: 3-5 items
- funnel: 3-5 items
- quote: 1 item
- cycle: 3-5 items
- thanks: 0 items
Returns
- A string containing the final task result (including the PPTX URL when available),
or an error/timeout message. |
| get_task_status | Get the current task status and result by task_id. |
| upload_document | Upload a document file and return the task_id for processing.
Supported file types: .pptx, .ppt, .docx, .doc, .xlsx, .pdf |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |