### Preview Examples with Live Reload

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

Recommended for testing, this command starts a local server to preview examples with live reload. Open http://localhost:8080 in your browser to view the examples.

```bash
pnpm run examples:server
```

--------------------------------

### Generate Markdown Examples

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

Use this command to generate markdown examples for the project. This is a common step in the development workflow.

```bash
pnpm run examples:generate
```

--------------------------------

### Quick Start Workflow

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

A recommended workflow for quickly creating and exporting a Marp presentation using the marp-mcp CLI.

```bash
marp-mcp -s rich create slides.md --title "My Talk" --subtitle "Author · Event" --slides 3
```

```bash
marp-mcp -s rich list-layouts
```

```bash
marp-mcp -s rich manage slides.md -l content --mode replace --slide-id <id> -p '{"heading":"Intro","body":"Hello world"}'
```

```bash
marp-mcp export slides.md -f html
```

--------------------------------

### Workflow: Quick Start

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

A recommended workflow for quickly creating and exporting a Marp presentation.

```APIDOC
## Workflow

### Quick Start (Recommended)

Use `create` to initialize a new presentation in one step, then add slides:

```bash
marp-mcp -s rich create slides.md --title "My Talk" --subtitle "Author · Event" --slides 3
marp-mcp -s rich list-layouts
marp-mcp -s rich manage slides.md -l content --mode replace --slide-id <id> -p '{"heading":"Intro","body":"Hello world"}'
marp-mcp export slides.md -f html
```
```

--------------------------------

### MCP Server Configuration

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Configuration examples for setting up the Marp MCP server in an MCP client.

```APIDOC
## MCP Server Setup

Configure the Marp MCP server in your MCP client configuration to enable AI-assisted presentation creation.

```json
{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest"]
    }
  }
}
```

```json
{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest", "-t", "default", "-s", "academic"]
    }
  }
}
```
```

--------------------------------

### Installation Check

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Verify if the marp-mcp CLI is installed or install it using npx.

```APIDOC
## Installation Check

Verify the CLI is available:

```bash
marp-mcp --version
```

If not installed, use npx:

```bash
npx @masaki39/marp-mcp@latest --version
```
```

--------------------------------

### Install Marp MCP Plugin

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

Install the Marp MCP plugin using the plugin marketplace command. This enables Claude Code to create Marp presentations via the /marp command.

```bash
/plugin marketplace add masaki39/marp-mcp
/plugin install marp@marp-mcp
```

--------------------------------

### Create Presentation

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Creates a new Marp presentation file with frontmatter, title slide, and optional placeholder slides in one step. This is the recommended way to start a new presentation.

```APIDOC
## create_presentation

Creates a new Marp presentation file with frontmatter, title slide, and optional placeholder slides in one step. This is the recommended way to start a new presentation.

### CLI Usage
```bash
# Create basic presentation
marp-mcp create slides.md --title "My Presentation"

# Create with subtitle and placeholder slides
marp-mcp -s tech create slides.md --title "Product Demo" --subtitle "Q3 2025 Launch" --slides 5
```
```

--------------------------------

### Generate HTML Files

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

This command generates HTML files from the markdown examples. These files are typically used for deployment or local preview.

```bash
pnpm run examples:html
```

--------------------------------

### Check marp-mcp CLI Installation

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Verify if the marp-mcp CLI is installed and accessible in your environment.

```bash
marp-mcp --version
```

```bash
npx @masaki39/marp-mcp@latest --version
```

--------------------------------

### List Layouts with Specific Theme and Style

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Get a list of available layouts filtered by a specific Marp theme and style. Replace `<theme>` and `<style>` with actual theme and style names.

```bash
marp-mcp -t <theme> -s <style> list-layouts
```

--------------------------------

### MCP Tool Call: Export to Editable PPTX

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object represents a tool call for exporting to PPTX format with the option to make the output editable. This feature requires LibreOffice to be installed.

```json
// MCP tool call: Export to editable PPTX (requires LibreOffice)
{
  "filePath": "/path/to/slides.md",
  "format": "pptx",
  "pptxEditable": true
}
```

--------------------------------

### Initialize Presentation with Frontmatter

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Use this command to set up the initial frontmatter for a Marp presentation, including theme, header, and pagination.

```bash
marp-mcp -s rich set-frontmatter slides.md --header "Title" --paginate
```

--------------------------------

### List Available Themes and Styles (CLI)

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use this CLI command to list all available Marp themes and styles, including their descriptions and layout counts. Call this first to understand visual options.

```bash
# CLI usage
marp-mcp list-themes-and-styles
```

--------------------------------

### Complete Workflow: List Available Layouts

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Step 2 of the complete workflow: Lists the available slide layouts for the currently set theme or style ('tech' in this case).

```bash
# Step 2: Check available layouts
marp-mcp -s tech list-layouts
```

--------------------------------

### Complete Workflow: Export to HTML for Preview

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Step 7 of the complete workflow: Exports the presentation to HTML format for a quick preview of the content and layout.

```bash
# Step 7: Export to HTML for preview
marp-mcp export presentation.md -f html
```

--------------------------------

### List Available Slide Layouts (CLI)

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use these CLI commands to list available slide layouts for a specific theme/style combination. This helps discover valid layout types before managing slides.

```bash
# CLI: List layouts for default theme
marp-mcp list-layouts
```

```bash
# CLI: List layouts for rich style
marp-mcp -s rich list-layouts
```

```bash
# CLI: List layouts for academic theme
marp-mcp -t academic list-layouts
```

--------------------------------

### create Command

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Create a new Marp presentation with frontmatter and a title slide.

```APIDOC
## `create <file>`

Create a new Marp presentation with frontmatter and a title slide in one step.

```bash
marp-mcp create slides.md --title "My Talk"
marp-mcp -s tech create slides.md --title "Product Demo" --subtitle "Q3 2025" --slides 5
```

Options:
- `--title <text>` — Presentation title (required)
- `--subtitle <text>` — Optional subtitle for the title slide
- `--no-paginate` — Disable slide page numbers
- `--slides <n>` — Number of blank content placeholder slides to add (default: `0`)
```

--------------------------------

### List Themes and Styles

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Lists all available themes and styles with their descriptions, compatible themes, and layout counts. Call this first to understand available visual options before creating a presentation.

```APIDOC
## list_themes_and_styles

Lists all available themes and styles with their descriptions, compatible themes, and layout counts. Call this first to understand available visual options before creating a presentation.

### CLI Usage
```bash
marp-mcp list-themes-and-styles
```

### Response Example
```json
{
  "currentDefaults": {
    "theme": "default",
    "style": "default"
  },
  "themes": [
    {
      "name": "default",
      "description": "Default Marp theme with clean design",
      "layoutCount": 7,
      "layouts": ["title", "section", "list", "table", "image-right", "image-center", "content"]
    },
    {
      "name": "academic",
      "description": "Academic conference presentation theme",
      "layoutCount": 15,
      "layouts": ["title", "section", "content", "list", "table", "two-column", "image-right", "image-center", "figure-caption", "key-message", "methodology", "comparison", "statistics", "sidebar", "results-table"]
    }
  ],
  "styles": [
    {
      "name": "rich",
      "description": "Rich visual style with cards, timelines, gradients",
      "compatibleThemes": ["default"],
      "layoutCount": 27
    },
    {
      "name": "dark",
      "description": "Dark mode style with indigo and emerald accents",
      "compatibleThemes": ["default"],
      "layoutCount": 22
    }
  ]
}
```
```

--------------------------------

### Add Slides with Layouts and Content

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Manage slides by adding them one by one using specified layouts and providing content through JSON parameters. Use this for 'title' and 'content' layouts.

```bash
marp-mcp -s rich manage slides.md -l title -p '{"heading":"My Talk","content":"Subtitle"}'
```

```bash
marp-mcp -s rich manage slides.md -l content -p '{"heading":"Intro","body":"Hello world"}'
```

--------------------------------

### List Available Layouts

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Retrieve a list of all available layouts for Marp presentations. This is useful for understanding what layouts can be used with the 'manage' command.

```bash
marp-mcp list-layouts
```

--------------------------------

### Create New Marp Presentation

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Create a new Marp presentation file with initial frontmatter and a title slide. You can specify a style, title, subtitle, and the number of placeholder slides.

```bash
marp-mcp create slides.md --title "My Talk"
```

```bash
marp-mcp -s tech create slides.md --title "Product Demo" --subtitle "Q3 2025" --slides 5
```

--------------------------------

### Complete Workflow: Create Presentation

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Step 1 of the complete workflow: Creates a new Marp presentation with a specified title and subtitle, using the 'tech' style.

```bash
# Step 1: Create presentation with tech style
marp-mcp -s tech create presentation.md --title "Product Launch" --subtitle "Engineering Team • Q4 2024"
```

--------------------------------

### list-layouts Command

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

List all available slide layouts in JSON format.

```APIDOC
## `list-layouts`

List all available slide layouts (JSON output).

```bash
marp-mcp list-layouts
marp-mcp -t gaia list-layouts
marp-mcp -s rich list-layouts
```
```

--------------------------------

### List Available Layouts

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

List all available slide layouts for Marp presentations. You can specify a theme or style to see layouts compatible with them.

```bash
marp-mcp list-layouts
```

```bash
marp-mcp -t gaia list-layouts
```

```bash
marp-mcp -s rich list-layouts
```

--------------------------------

### Complete Workflow: Add Roadmap Slide

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Step 6 of the complete workflow: Manages the presentation by adding a 'roadmap' layout slide with a heading and a list of milestones, each with a title, description, and status.

```bash
# Step 6: Add roadmap slide
marp-mcp -s tech manage presentation.md -l roadmap -p '{
  "heading": "2025 Roadmap",
  "milestones": [
    "Q1|Beta Launch|done",
    "Q2|Public Release|current",
    "Q3|Enterprise Features|future",
    "Q4|International Expansion|future"
  ]
}'
```

--------------------------------

### Create New Marp Presentation (CLI)

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use this CLI command to create a new Marp presentation file. It supports adding a title, subtitle, and placeholder slides.

```bash
# CLI: Create basic presentation
marp-mcp create slides.md --title "My Presentation"
```

```bash
# CLI: Create with subtitle and placeholder slides
marp-mcp -s tech create slides.md --title "Product Demo" --subtitle "Q3 2025 Launch" --slides 5
```

--------------------------------

### Export with Custom Theme

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Allows you to specify a custom CSS theme file for the export. This enables further customization of the presentation's appearance.

```bash
# CLI: Export with custom theme
marp-mcp export slides.md -f html --theme-set /path/to/custom-theme.css
```

--------------------------------

### Complete Workflow: Add Statistics Slide

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Step 5 of the complete workflow: Manages the presentation by adding a 'statistics' layout slide with a heading and key performance metrics.

```bash
# Step 5: Add statistics slide
marp-mcp -s tech manage presentation.md -l statistics -p '{
  "heading": "Performance Metrics",
  "stats": ["99.99%|Uptime", "10M+|Users", "500ms|Avg Response"]
}'
```

--------------------------------

### Add Marp MCP Server (User Scope)

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

Add the Marp MCP server to your user scope using the Claude CLI. This is the recommended method for individual use.

```bash
claude mcp add marp-mcp -- npx -y @masaki39/marp-mcp@latest
```

--------------------------------

### Set Marp MCP Server Default Theme and Style

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

Configure the Marp MCP server's default theme and style using command-line arguments. Available themes include 'default', 'gaia', 'uncover', 'academic', and styles include 'default', 'rich', 'minimal', 'dark', 'corporate', 'academic', 'tech'.

```json
{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest", "-t", "default", "-s", "academic"]
    }
  }
}
```

--------------------------------

### Add Marp MCP Server (Project Scope)

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

Add the Marp MCP server to your project scope using the Claude CLI. This allows team sharing via a .mcp.json file.

```bash
claude mcp add --scope project marp-mcp -- npx -y @masaki39/marp-mcp@latest
```

--------------------------------

### manage Command

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Insert, replace, or delete slides using slide IDs.

```APIDOC
## `manage <file>`

Insert, replace, or delete slides using slide IDs.

```bash
marp-mcp manage slides.md -l title -p '{"heading":"Hello","content":"World"}'
marp-mcp manage slides.md -l content -p '{"heading":"Agenda","body":"- Item 1\n- Item 2"}' --position after --slide-id <id>
marp-mcp manage slides.md -l content --mode replace --slide-id <id> -p '{"heading":"Updated","body":"New content"}'
marp-mcp manage slides.md --mode delete --slide-id <id>
```

Options:
- `-l, --layout <type>` — Layout type (required for insert/replace)
- `-p, --params <json>` — Parameters as JSON string (default: `{}`)
- `-m, --mode <mode>` — Operation mode: `insert` | `replace` | `delete` (default: `insert`)
- `--position <pos>` — Position: `end` | `start` | `after` | `before` (default: `end`)
- `--slide-id <id>` — Target slide ID (required for `after`, `before`, `replace`, `delete`)
- `--note <text>` — Speaker notes
```

--------------------------------

### MCP Tool Response for Presentation Creation

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object is a response from the MCP tool after creating a presentation, indicating success and providing file details.

```json
{
  "message": "Created presentation with 4 slides",
  "filePath": "/absolute/path/to/presentation.md",
  "title": "Quarterly Review",
  "totalSlides": 4,
  "workflow": [
    "Use list_layouts to see available layouts",
    "Use manage_slide to add or edit slides",
    "Use read_slide to list all slides and their IDs",
    "Use export_slide to export to HTML or PDF"
  ]
}
```

--------------------------------

### Complete Workflow: Add Feature Grid Slide

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Step 4 of the complete workflow: Manages the presentation by adding a 'feature-grid' layout slide with specified heading and features. Each feature is defined by an icon, title, and description.

```bash
# Step 4: Add a feature grid slide
marp-mcp -s tech manage presentation.md -l feature-grid -p '{
  "heading": "Key Features",
  "features": [
    "🚀|Fast|Sub-100ms response times",
    "🔒|Secure|End-to-end encryption",
    "📱|Mobile|Native iOS and Android apps",
    "🌐|Global|Available in 50+ countries"
  ]
}'
```

--------------------------------

### Migrate JavaScript fetch to async/await

Source: https://github.com/masaki39/marp-mcp/blob/main/assets/examples/md/example-default-dark-style.md

Compares the 'before' and 'after' of using async/await for fetch operations in JavaScript. The 'after' version uses await to handle asynchronous responses.

```javascript
const data = fetch(url)
const json = data.json()
console.log(json)
```

```javascript
const data = await fetch(url)
const json = await data.json()
console.log(json)
```

--------------------------------

### Async/Await Pattern in TypeScript

Source: https://github.com/masaki39/marp-mcp/blob/main/assets/examples/md/example-default-dark-style.md

Demonstrates fetching user data using async/await in TypeScript. This pattern improves readability and error handling for asynchronous operations.

```typescript
async function fetchUser(id: string) {
  const res = await fetch(`/api/users/${id}`)
  if (!res.ok) throw new Error('Not found')
  return res.json() as Promise<User>
}
```

--------------------------------

### Export Marp Presentation to HTML

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use this CLI command to export a Marp presentation to HTML format. This format preserves all styling and rendering.

```bash
# CLI: Export to HTML
marp-mcp export slides.md -f html
```

--------------------------------

### List Layouts

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Lists all available slide layouts for a specific theme/style combination with their required and optional parameters. Always call this before using manage_slide to discover valid layout types.

```APIDOC
## list_layouts

Lists all available slide layouts for a specific theme/style combination with their required and optional parameters. Always call this before using manage_slide to discover valid layout types.

### CLI Usage
```bash
# List layouts for default theme
marp-mcp list-layouts

# List layouts for rich style
marp-mcp -s rich list-layouts

# List layouts for academic theme
marp-mcp -t academic list-layouts
```

### Request Example
```json
{
  "theme": "default",
  "style": "rich"
}
```

### Response Example
```json
{
  "theme": "default",
  "style": "rich",
  "layouts": [
    {
      "name": "title",
      "description": "Hero title slide with dark gradient background",
      "params": [
        { "name": "heading", "type": "string", "required": true, "description": "Main title text" },
        { "name": "content", "type": "string", "required": false, "description": "Subtitle or author info" }
      ]
    },
    {
      "name": "statistics",
      "description": "Statistics display with large numbers and labels",
      "params": [
        { "name": "heading", "type": "string", "required": true },
        { "name": "stats", "type": "array", "required": true, "description": "Use 'Number|Label' format" }
      ]
    },
    {
      "name": "timeline",
      "description": "Vertical timeline with labeled events",
      "params": [
        { "name": "heading", "type": "string", "required": true },
        { "name": "events", "type": "array", "required": true, "description": "Use 'Label: Description' format" }
      ]
    }
  ]
}
```
```

--------------------------------

### Complete Workflow: Export Final PDF

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Step 8 of the complete workflow: Exports the final presentation to PDF format, specifying an output path for the finalized document.

```bash
# Step 8: Export final PDF
marp-mcp export presentation.md -f pdf -o ./final-presentation.pdf
```

--------------------------------

### Complete Workflow: Read Slides

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Step 3 of the complete workflow: Reads the presentation file to retrieve existing slide IDs, which is useful for targeted slide management.

```bash
# Step 3: Read slides to get IDs
marp-mcp read presentation.md
```

--------------------------------

### export Command

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Export a Marp presentation to HTML or PDF.

```APIDOC
## `export <file>`

Export a Marp presentation to HTML or PDF.

```bash
marp-mcp export slides.md -f html
marp-mcp export slides.md -f pdf -o /tmp/presentation.pdf
```

Options:
- `-f, --format <format>` — Output format: `html` | `pdf` (required)
- `-o, --output <path>` — Output file path (default: same directory as input)
- `--allow-local-files` — Allow local image file access in HTML export
- `--theme-set <path>` — Path to a custom theme CSS file
```

--------------------------------

### Themes and Styles

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Information on available Marp themes and styles that can be applied to presentations.

```APIDOC
## Available Themes and Styles

- **Theme** (`-t`): Base CSS that defines the slide foundation. Each theme is a standalone CSS file in the repository.
- **Style** (`-s`): Additional CSS layouts and components layered on top of a theme. Styles are designed for the `default` theme, so `-s` implies `-t default` unless explicitly overridden.

### Themes

`academic`, `default`, `gaia`, `uncover`

### Styles

| Style | Description |
|-------|-------------|
| `rich` | Rich visual style with cards, timelines, grids, gradients, and more |
| `minimal` | Clean, flat design with typography focus and minimal decoration |
| `dark` | Dark mode style with indigo and emerald accents, developer-friendly |
| `corporate` | Professional business style with navy color scheme, structured layouts |
| `academic` | Academic conference presentation style with maroon color scheme, structured for scholarly talks |
| `tech` | Modern tech/startup style with violet-cyan gradient accents, strong typography for product demos and engineering talks |
```

--------------------------------

### Manual MCP Server Configuration

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

Configure the Marp MCP server manually in your Claude settings. This can be done in '~/.claude/settings.json' or a project-specific '.mcp.json' file.

```json
{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest"]
    }
  }
}
```

--------------------------------

### Set Marp Frontmatter: With Header and Pagination

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use the marp-mcp set-frontmatter command to initialize or update Marp frontmatter, including header and pagination settings.

```bash
marp-mcp set-frontmatter slides.md --header "My Presentation" --paginate
```

--------------------------------

### MCP Server Response: HTML Export Warning

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This response indicates a successful HTML export but includes a warning about detected local image paths, suggesting potential display issues and recommending PDF format.

```json
// Response with warning for local images in HTML
{
  "message": "Exported successfully to HTML",
  "outputPath": "/path/to/slides.html",
  "format": "html",
  "sourceFile": "/path/to/slides.md",
  "warning": "Local image paths detected: [./images/logo.png]. HTML export may not display these correctly. Consider using PDF format instead."
}
```

--------------------------------

### Set Frontmatter Fields

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Add or update Marp frontmatter fields in a presentation file. Use options like --header and --paginate to configure frontmatter settings.

```bash
marp-mcp set-frontmatter slides.md --header "My Presentation" --paginate
```

```bash
marp-mcp -s academic set-frontmatter slides.md --header "Research Talk"
```

--------------------------------

### MCP Tool Call for Presentation Creation

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object represents a tool call to the MCP for creating a presentation with specified metadata.

```json
{
  "filePath": "/absolute/path/to/presentation.md",
  "title": "Quarterly Review",
  "subtitle": "Q3 2024 Results",
  "paginate": true,
  "slideCount": 3
}
```

--------------------------------

### read Command

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Read slide content from a Marp file.

```APIDOC
## `read <file>`

Read slide content from a Marp file.

```bash
marp-mcp read slides.md
marp-mcp read slides.md --slide-id <id>
```

Options:
- `--slide-id <id>` — Read a specific slide by ID (omit to list all slides with their IDs)
```

--------------------------------

### MCP Tool Call: Export to HTML with Local Images

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object represents a tool call for exporting to HTML, enabling local file access to include local images.

```json
// MCP tool call: Export to HTML with local images
{
  "filePath": "/path/to/slides.md",
  "format": "html",
  "allowLocalFiles": true
}
```

--------------------------------

### Read Marp Slides: List All Slides

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use the marp-mcp read command without any flags to list all slides in a Marp presentation along with their IDs and positions.

```bash
marp-mcp read slides.md
```

--------------------------------

### Create Marp Presentation without Pagination

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use the marp-mcp create command to generate a new Marp presentation. The --no-paginate flag disables pagination for the presentation.

```bash
marp-mcp -s corporate create slides.md --title "Board Meeting" --no-paginate
```

--------------------------------

### Set Frontmatter

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Initializes or updates required Marp frontmatter fields (marp, theme, header, paginate) and injects active style CSS. Recommended to call this first when manually creating a presentation.

```APIDOC
## POST /api/frontmatter/set

### Description
Configures the Marp frontmatter for a presentation, setting essential fields like theme, header, and pagination status. It also injects the active CSS style.

### Method
POST

### Endpoint
/api/frontmatter/set

### Parameters
#### Query Parameters
- **filePath** (string) - Required - The path to the Marp presentation file.
- **header** (string) - Optional - Sets the presentation header.
- **paginate** (boolean) - Optional - Enables or disables pagination. If not provided, it defaults to the existing setting or Marp's default.
- **theme** (string) - Optional - Specifies the Marp theme to use (e.g., 'default', 'gaia', 'uncover').
- **style** (string) - Optional - Applies a specific style or theme variant (e.g., 'corporate', 'academic').

### Request Body
(No specific request body is defined for this operation; parameters are typically passed via query parameters or CLI arguments.)

### Request Example
```json
// MCP tool call
{
  "filePath": "/path/to/slides.md",
  "header": "Quarterly Review",
  "paginate": true,
  "theme": "default",
  "style": "corporate"
}
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating successful update.
- **file** (string) - The path to the updated presentation file.
- **style** (string) - The style applied to the presentation.
- **frontmatter** (object) - An object containing the updated frontmatter fields.
  - **marp** (boolean) - Indicates if Marp is enabled.
  - **theme** (string) - The active theme.
  - **header** (string) - The presentation header.
  - **paginate** (boolean) - Pagination status.

#### Response Example
```json
{
  "message": "Updated frontmatter successfully",
  "file": "/path/to/slides.md",
  "style": "corporate",
  "frontmatter": {
    "marp": true,
    "theme": "default",
    "header": "Quarterly Review",
    "paginate": true
  }
}
```
```

--------------------------------

### Themes and Styles Response Structure

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON structure details the available Marp themes and styles, including their names, descriptions, compatible themes, and layout counts.

```json
// MCP tool response structure
{
  "currentDefaults": {
    "theme": "default",
    "style": "default"
  },
  "themes": [
    {
      "name": "default",
      "description": "Default Marp theme with clean design",
      "layoutCount": 7,
      "layouts": ["title", "section", "list", "table", "image-right", "image-center", "content"]
    },
    {
      "name": "academic",
      "description": "Academic conference presentation theme",
      "layoutCount": 15,
      "layouts": ["title", "section", "content", "list", "table", "two-column", "image-right", "image-center", "figure-caption", "key-message", "methodology", "comparison", "statistics", "sidebar", "results-table"]
    }
  ],
  "styles": [
    {
      "name": "rich",
      "description": "Rich visual style with cards, timelines, grids, gradients",
      "compatibleThemes": ["default"],
      "layoutCount": 27
    },
    {
      "name": "dark",
      "description": "Dark mode style with indigo and emerald accents",
      "compatibleThemes": ["default"],
      "layoutCount": 22
    }
  ]
}
```

--------------------------------

### Manage Marp Slides: Add Slide with Speaker Notes

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use the marp-mcp manage command to add a slide and include speaker notes using the --note flag.

```bash
marp-mcp manage slides.md -l content -p '{"heading":"Key Point","body":"Important info"}' --note "Remember to pause here"
```

--------------------------------

### MCP Server Response: Export Successful

Source: https://context7.com/masaki39/marp-mcp/llms.txt

A successful export response from the MCP server, confirming the output format, path, and source file.

```json
// Response
{
  "message": "Exported successfully to PDF",
  "outputPath": "/path/to/output/presentation.pdf",
  "format": "pdf",
  "sourceFile": "/path/to/slides.md"
}
```

--------------------------------

### Export Marp Presentation

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Export a Marp presentation to HTML or PDF format. Specify the output format and optionally an output file path.

```bash
marp-mcp export slides.md -f html
```

```bash
marp-mcp export slides.md -f pdf -o /tmp/presentation.pdf
```

--------------------------------

### Global Options

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Global options applicable to all marp-mcp commands.

```APIDOC
## Global Options

- `-t, --theme <name>` — Select theme (default: `default`)
- `-s, --style <name>` — Select style (default: `default`)
- `-V, --version` — Show version
- `-h, --help` — Show help
```

--------------------------------

### Set Marp Frontmatter: With Academic Style

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use the marp-mcp set-frontmatter command with a style flag (e.g., -s academic) to apply a specific theme to the presentation's frontmatter.

```bash
marp-mcp -s academic set-frontmatter slides.md --header "Research Talk"
```

--------------------------------

### MCP Tool Call: List All Slides

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object represents a tool call to the MCP to list all slides within a specified Marp presentation file.

```json
{
  "filePath": "/path/to/slides.md"
}
```

--------------------------------

### MCP Tool Call: Export to PDF

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object represents a tool call to the MCP server for exporting a presentation to PDF. It specifies the file path, format, and output path.

```json
// MCP tool call: Export to PDF
{
  "filePath": "/path/to/slides.md",
  "format": "pdf",
  "outputPath": "/path/to/output/presentation.pdf"
}
```

--------------------------------

### Layouts Response Structure

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON structure details the available slide layouts for a given theme and style, including layout names, descriptions, and required/optional parameters.

```json
// MCP tool response structure
{
  "theme": "default",
  "style": "rich",
  "layouts": [
    {
      "name": "title",
      "description": "Hero title slide with dark gradient background",
      "params": [
        { "name": "heading", "type": "string", "required": true, "description": "Main title text" },
        { "name": "content", "type": "string", "required": false, "description": "Subtitle or author info" }
      ]
    },
    {
      "name": "statistics",
      "description": "Statistics display with large numbers and labels",
      "params": [
        { "name": "heading", "type": "string", "required": true },
        { "name": "stats", "type": "array", "required": true, "description": "Use 'Number|Label' format" }
      ]
    },
    {
      "name": "timeline",
      "description": "Vertical timeline with labeled events",
      "params": [
        { "name": "heading", "type": "string", "required": true },
        { "name": "events", "type": "array", "required": true, "description": "Use 'Label: Description' format" }
      ]
    }
  ]
}
```

--------------------------------

### Export Marp Presentation to PDF

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This command exports a Marp presentation to PDF format, suitable for printing. You can specify a custom output path using the -o flag.

```bash
# CLI: Export to PDF with custom output path
marp-mcp export slides.md -f pdf -o /tmp/presentation.pdf
```

--------------------------------

### Export HTML with Local File Access

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Enables local file access during HTML export, which can be useful for including local images or assets in your presentation.

```bash
# CLI: Export HTML with local file access
marp-mcp export slides.md -f html --allow-local-files
```

--------------------------------

### Create Slides without Pagination

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This command creates a Marp presentation from a Markdown file, with options to set the title and disable pagination.

```APIDOC
## POST /api/slides/create

### Description
Creates a Marp presentation from a Markdown file without pagination.

### Method
POST

### Endpoint
/api/slides/create

### Parameters
#### Query Parameters
- **title** (string) - Optional - The title for the presentation.
- **no-paginate** (boolean) - Optional - If true, pagination will be disabled.

### Request Body
- **filePath** (string) - Required - The path to the Markdown file.

### Request Example
```json
{
  "filePath": "/absolute/path/to/presentation.md",
  "title": "Quarterly Review",
  "subtitle": "Q3 2024 Results",
  "paginate": true,
  "slideCount": 3
}
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message.
- **filePath** (string) - The path to the created presentation file.
- **title** (string) - The title of the presentation.
- **totalSlides** (integer) - The total number of slides.
- **workflow** (array) - A list of recommended next steps or available commands.

#### Response Example
```json
{
  "message": "Created presentation with 4 slides",
  "filePath": "/absolute/path/to/presentation.md",
  "title": "Quarterly Review",
  "totalSlides": 4,
  "workflow": [
    "Use list_layouts to see available layouts",
    "Use manage_slide to add or edit slides",
    "Use read_slide to list all slides and their IDs",
    "Use export_slide to export to HTML or PDF"
  ]
}
```
```

--------------------------------

### Configure Marp MCP Server in MCP Client

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Configure your MCP client to use the Marp MCP server. This JSON snippet defines the server connection.

```json
{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest"]
    }
  }
}
```

```json
{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest", "-t", "default", "-s", "academic"]
    }
  }
}
```

--------------------------------

### set-frontmatter Command

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Add or update Marp frontmatter fields in a presentation file.

```APIDOC
## `set-frontmatter <file>`

Add or update Marp frontmatter fields.

```bash
marp-mcp set-frontmatter slides.md --header "My Presentation" --paginate
marp-mcp -s academic set-frontmatter slides.md --header "Research Talk"
```

Options:
- `--header <text>` — Header text
- `--paginate / --no-paginate` — Enable or disable pagination
```

--------------------------------

### Override Theme and Style for Single Call

Source: https://github.com/masaki39/marp-mcp/blob/main/README.md

Override the server-wide default theme and style for a single API call. This allows handling multiple theme/style combinations without restarting the server. Omit either parameter to fall back to the server default.

```json
{ "theme": "gaia", "style": "rich" }
```

--------------------------------

### Edit Slides Using Replace Mode and Slide IDs

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Update existing slides by using the 'replace' mode along with a specific slide ID and new content provided via JSON.

```bash
marp-mcp -s rich manage slides.md -l content --mode replace --slide-id <id> -p '{"heading":"Updated","body":"New content"}'
```

--------------------------------

### Export Marp Presentation

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Export your Marp presentation to various formats, such as HTML or PDF, for sharing or previewing.

```bash
marp-mcp export slides.md -f html
```

--------------------------------

### MCP Tool Response: All Slides

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object is a response from the MCP tool containing details of all slides in a Marp presentation, including their IDs, positions, and content.

```json
{
  "totalSlides": 3,
  "slides": [
    {
      "slideId": "uuid-1",
      "position": 1,
      "content": "<!-- slide-id: uuid-1 -->\n\n# Welcome\n\nIntroduction slide content"
    },
    {
      "slideId": "uuid-2",
      "position": 2,
      "content": "<!-- slide-id: uuid-2 -->\n\n# Agenda\n\n- Item 1\n- Item 2"
    },
    {
      "slideId": "uuid-3",
      "position": 3,
      "content": "<!-- slide-id: uuid-3 -->\n\n# Details\n\nMain content here"
    }
  ],
  "file": "/path/to/slides.md"
}
```

--------------------------------

### Manage Slides

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Inserts, replaces, or deletes slides in a Marp presentation. Supports various layouts with customizable parameters and speaker notes.

```APIDOC
## POST /api/slides/manage

### Description
Manages slides within a Marp presentation by inserting, replacing, or deleting them. Supports various predefined layouts and custom parameters.

### Method
POST

### Endpoint
/api/slides/manage

### Parameters
#### Query Parameters
- **filePath** (string) - Required - The path to the Marp presentation file.
- **layoutType** (string) - Optional - The type of layout for the new slide (e.g., 'title', 'list', 'content', 'statistics', 'timeline').
- **mode** (string) - Optional - The operation mode: 'insert' (default), 'replace', or 'delete'.
- **position** (string) - Optional - For insertion: 'start', 'end', 'after', or 'before'. Defaults to 'end' if not specified.
- **slideId** (string) - Optional - The ID of the slide to replace, delete, or insert after/before.
- **style** (string) - Optional - Applies a specific style to the slide (e.g., 'rich').

#### Request Body
- **params** (object) - Required for insert/replace - Parameters specific to the chosen layoutType. For example, for a 'list' layout, it might contain 'heading' and 'items'.
- **note** (string) - Optional - Speaker notes for the slide.

### Request Example
```json
// MCP tool call: Insert statistics slide with rich style
{
  "filePath": "/path/to/slides.md",
  "layoutType": "statistics",
  "params": {
    "heading": "Key Metrics",
    "stats": ["150K|Active Users", "99.9%|Uptime", "4.8|App Rating"]
  },
  "mode": "insert",
  "position": "end",
  "style": "rich"
}

// MCP tool call: Insert timeline
{
  "filePath": "/path/to/slides.md",
  "layoutType": "timeline",
  "params": {
    "heading": "Project Milestones",
    "events": ["Q1: Research Phase", "Q2: Development", "Q3: Beta Launch", "Q4: General Availability"]
  },
  "mode": "insert",
  "position": "after",
  "slideId": "existing-slide-id",
  "style": "rich"
}
```

### Response
#### Success Response (200)
- **operation** (string) - Description of the performed operation.
- **slideId** (string) - The ID of the affected or newly created slide.
- **layoutType** (string) - The layout type used for the operation.
- **totalSlides** (integer) - The total number of slides after the operation.
- **file** (string) - The path to the modified presentation file.

#### Response Example
```json
{
  "operation": "Inserted slide at position 3 (after)",
  "slideId": "generated-uuid-here",
  "layoutType": "timeline",
  "totalSlides": 5,
  "file": "/path/to/slides.md"
}
```
```

--------------------------------

### Manage Slides in Marp Presentation

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Insert, replace, or delete slides within a Marp presentation file using slide IDs. Requires specifying layout, parameters (as JSON), mode, and optionally position and slide ID.

```bash
marp-mcp manage slides.md -l title -p '{"heading":"Hello","content":"World"}'
```

```bash
marp-mcp manage slides.md -l content -p '{"heading":"Agenda","body":"- Item 1\n- Item 2"}' --position after --slide-id <id>
```

```bash
marp-mcp manage slides.md -l content --mode replace --slide-id <id> -p '{"heading":"Updated","body":"New content"}'
```

```bash
marp-mcp manage slides.md --mode delete --slide-id <id>
```

--------------------------------

### generate-ids Command

Source: https://github.com/masaki39/marp-mcp/blob/main/skills/marp/SKILL.md

Generate slide IDs for every slide in a Marp markdown file.

```APIDOC
## `generate-ids <file>`

Generate slide IDs for every slide in a Marp markdown file. Safe to run multiple times — existing IDs are never changed.

```bash
marp-mcp generate-ids slides.md
```
```

--------------------------------

### MCP Server Response: All Slides Have IDs

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON response is returned when all slides in the Marp file already possess IDs, meaning no new IDs were generated.

```json
// Response when all slides already have IDs
{
  "message": "All slides already have IDs",
  "totalSlides": 5,
  "file": "/path/to/slides.md"
}
```

--------------------------------

### MCP Tool Call: Generate Slide IDs

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object represents a tool call to the MCP server for generating slide IDs. It requires the file path of the Marp presentation.

```json
// MCP tool call
{
  "filePath": "/path/to/slides.md"
}
```

--------------------------------

### MCP Tool Call: Set Frontmatter

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object represents a tool call to the MCP for setting the frontmatter of a Marp presentation with specified header and pagination options.

```json
{
  "filePath": "/path/to/slides.md",
  "header": "Quarterly Review",
  "paginate": true,
  "theme": "default",
  "style": "corporate"
}
```

--------------------------------

### Set Marp Frontmatter: Disable Pagination

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use the marp-mcp set-frontmatter command with the --no-paginate flag to disable pagination for the presentation.

```bash
marp-mcp set-frontmatter slides.md --header "Title" --no-paginate
```

--------------------------------

### MCP Tool Response: Set Frontmatter

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON object is a response from the MCP tool after successfully updating the frontmatter of a Marp presentation.

```json
{
  "message": "Updated frontmatter successfully",
  "file": "/path/to/slides.md",
  "style": "corporate",
  "frontmatter": {
    "marp": true,
    "theme": "default",
    "header": "Quarterly Review",
    "paginate": true
  }
}
```

--------------------------------

### Manage Marp Slides: Replace Existing Slide

Source: https://context7.com/masaki39/marp-mcp/llms.txt

Use the marp-mcp manage command with --mode replace and --slide-id to replace an existing slide with new content.

```bash
marp-mcp manage slides.md -l content --mode replace --slide-id abc-123 -p '{"heading":"Updated Title","body":"New content"}'
```

--------------------------------

### MCP Server Response: IDs Generated

Source: https://context7.com/masaki39/marp-mcp/llms.txt

This JSON response indicates that slide IDs were successfully generated for the specified Marp file. It includes the total number of slides and IDs generated.

```json
// Response when IDs are generated
{
  "message": "Generated slide IDs successfully",
  "totalSlides": 5,
  "idsGenerated": 5,
  "file": "/path/to/slides.md"
}
```