MCP Integration

Connect SlideForge as an MCP (Model Context Protocol) server to use slide generation as a native tool in Claude Desktop, Cursor, or any MCP-compatible client.

What is MCP?

The Model Context Protocol lets AI agents call external tools. When you add SlideForge as an MCP server, your AI can generate, iterate, and manage slides directly in conversation. Results include inline PNG previews and downloadable .pptx files.

Claude Desktop

Add this to your claude_desktop_config.json:

claude_desktop_config.json

{
  "mcpServers": {
    "slideforge": {
      "url": "https://api.slideforge.dev/mcp/",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sf_live_YOUR_KEY"
      }
    }
  }
}

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Go to Settings → MCP Servers → Add Server, or add to your .cursor/mcp.json:

.cursor/mcp.json

{
  "mcpServers": {
    "slideforge": {
      "url": "https://api.slideforge.dev/mcp/",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sf_live_YOUR_KEY"
      }
    }
  }
}

Windsurf

Open Settings → search “MCP” → click the Marketplace link, or edit the config file directly:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "slideforge": {
      "url": "https://api.slideforge.dev/mcp/",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer sf_live_YOUR_KEY"
      },
      "disabled": false
    }
  }
}

On Windows: %APPDATA%\Windsurf\User\settings.json
On Linux: ~/.config/Windsurf/User/settings.json

Claude Code (CLI)

Add to your project's .mcp.json or global ~/.claude/mcp.json:

.mcp.json

{
  "mcpServers": {
    "slideforge": {
      "url": "https://api.slideforge.dev/mcp/",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sf_live_YOUR_KEY"
      }
    }
  }
}

Any MCP-compatible client

SlideForge works with any client that supports Streamable HTTP transport. The MCP endpoint is https://api.slideforge.dev/mcp/. Pass your API key as Authorization: Bearer sf_live_... in the headers. OAuth 2.1 is also supported for interactive clients — the server handles the flow automatically.

Available Tools

27 tools across 6 categories. Also includes 2 prompts (create_presentation, quick_slide) for guided workflows.

Tool	Description	Parameters
Slide Generation
render_slide	Render from a template — sync for params, async for brief. <1s, $0.03-$0.05.	template, params?, brief?, theme_id?, chrome?, language?
generate_slide	AI-designed slide from a brief. Custom layouts, visual QA. ~12-40s, $0.20.	brief, strategy?, theme_id?, chrome?, from_image?, language?
iterate_slide	Improve a slide with text feedback. ~15s, $0.10.	job_id, feedback, language?
render_spec	Render from a declarative Flexbox + component spec. Deterministic, <1s, $0.03-$0.05.	spec, theme_id?, include_preview?
suggest_layout	LLM generates a render_spec-compatible JSON spec from a brief. Free.	brief, theme_id?
render_preflight	Validate template + params without rendering or charging. Free.	template, params?
Deck Workflows
generate_deck	Multi-slide deck — each slide rendered or AI-generated in parallel.	slides[], strategy?, theme_id?, title?, language?
consulting_deck	One call → finished consulting deck with narrative structure. $0.30-$1.20.	topic, audience?, slide_count?, tone?, theme_id?, language?
assemble_deck	Merge existing slide jobs into a deck. No generation — just compile. Free.	job_ids[], theme_id?, title?
fork_deck	Create a variant of an existing deck (A/B, per-audience). Free.	deck_id, name?, title?
translate_deck	Translate an uploaded .pptx preserving all formatting. $0.02/slide.	pptx_url \| pptx_base64, target_language, include_notes?
Template & Component Discovery
suggest_template	Best template for a brief (single or batch). Returns ranked matches with schemas.	brief \| briefs[], top?
search_templates	Semantic search across templates — ranked by relevance.	query, category?, top?
list_templates	Browse all 50 built-in templates. Filter by category, audience, style.	category?, audience?, style?, detail?
search_components	Semantic search for design system components.	query, category?, top?
list_components	Browse all 24 design system components (Metric, BarList, Table, etc.).	category?
Jobs & Status
get_slide_status	Poll job status. Returns pptx_url + preview when complete.	job_id, include_preview?
list_jobs	List recent jobs with filtering.	status?, limit?
Account & Discovery
get_me	Current user identity, plan, and wallet balance.	-
get_usage	Detailed usage stats — balance, spend breakdown, daily history.	days?
get_capabilities	API capabilities, available tools, and account limits.	-
get_agent_onboarding	Onboarding playbook for agents evaluating SlideForge. Free.	-
list_themes	List available themes (8 built-in + custom).	-
Utilities
upload_file	Upload a file (logo, theme .pptx, translate source, PDF). Max 5 MB.	content_b64, content_type, purpose, target_language?
submit_feedback	Submit feedback — bugs, feature requests, quality issues. Rewards available.	subject, category, severity, description, job_id?

Example conversation

You:

"Create a KPI dashboard: revenue $12.4M (+18% YoY), 847 new clients (+23%), NPS 71"

AI:

Calls suggest_template → finds a KPI template → calls render_slide with structured params → returns result instantly (sync 200, no polling needed).

You:

"Now generate a 2x2 matrix comparing build vs buy with cost and speed axes"

AI:

No template fits → calls generate_slide, polls get_slide_status every 3s, shows PNG preview inline with .pptx download link.

You:

"Make the Build column header larger and add a green checkmark icon"

AI:

Calls iterate_slide with feedback, shows updated preview.