slideforge-mcp AGENTS.md

SlideForge — agent instructions

SlideForge (slideforge.dev, by Smart Data Brokers GmbH) turns typed slide intents into native, fully editable PowerPoint files. It is a compiler, not a generator: a deterministic engine renders 200+ catalog patterns from structured content — no LLM in the render path — and every response carries a fidelity manifest stating what was bound verbatim vs. model-completed. Copy this file (or its rules) into a project where an agent produces .pptx deliverables.

Connect

MCP (preferred — tools + schemas are self-describing):

# Claude Code
claude mcp add --transport http slideforge https://api.slideforge.dev/mcp/
# Codex CLI / Cursor / Windsurf: streamable-http MCP server at the same URL,
# header "Authorization: Bearer sf_live_YOUR_KEY"

REST (everything also works without MCP): https://api.slideforge.dev/v1/… with the same Bearer key. Reference: https://slideforge.dev/docs/api — machine-readable rate card at GET /v1/pricing.

The workflow that works

1. Discover the form. browse_catalog (or GET /v1/catalog) → pick a form (kpi_metrics, waterfall_bridge, gantt_plan, org_structure, funnel, data_table, …). browse_catalog type=schema form=<form> returns the JSON Schema and a copy-pasteable example intent — start from the example, swap in real content, keep the field names. Unsure which form? plan_slide with the brief is free.
2. Dry-run first. Send the intent with dry_run: true → validation + a fidelity forecast at $0. Fix errors[] (each has a machine code + remedy), then resend without dry_run.
3. Render. create_slide (one) or create_deck (slides[], parallel, failed slides are isolated and free). $0.05/slide, usable-or-free: a render with blocking errors never bills.
4. Verify like an agent. The preview PNG is embedded inline in the tool result — look at it before declaring done, no fetch needed. Download the deliverable via header-auth: GET /v1/jobs/<job_id>/pptx with Authorization: Bearer sf_live_YOUR_KEY. To hand off a shareable link, POST /v1/jobs/<job_id>/download-url mints a short-TTL single-use one.
5. Trust the manifest, not vibes. fidelity: verbatim = every number/word came from your input. ai_completed/mixed = the response names which fields a model filled. partial = some supplied content didn't make it onto the slide — the manifest names what was dropped; never deliver a partial render without telling the user what's missing. Surface fidelity to the user when the content is business data.