Use SlideForge from your agent framework

August 10, 2026 · View on GitHub

SlideForge is an MCP server, so LangChain and LlamaIndex load its tools directly — you don't need a SlideForge SDK. Point the framework's MCP adapter at https://api.slideforge.dev/mcp/ with your API key and all 7 tools become agent tools. Your agent's numbers bind verbatim (no model in the render path), and every response carries status / fidelity / warnings so the agent can trust the render — or know exactly why not.

Runnable files: langchain_slideforge.py · llamaindex_slideforge.py Both verified end-to-end against production on 2026-07-24 (real .pptx out).

No-code / low-code: n8n — nothing to install. n8n's first-party MCP Client Tool connects to us directly (Cloud and self-hosted), or use the plain HTTP Request node for pipelines with no LLM in the loop. Transport must be HTTP Streamable, not SSE.

Get a key (free, ~30 seconds)

Sign up60 free slides, no credit card, no subscription → copy your key from slideforge.dev/console/keys.

export SLIDEFORGE_API_KEY=sf_live_...

That one key works for MCP and REST. Discovery (browse_catalog, plan_slide) and dry_run are free and never touch the 60 — you only spend on an actual render, and a render that isn't usable never bills.

LangChain / LangGraph

pip install langchain-mcp-adapters
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "slideforge": {
        "transport": "streamable_http",
        "url": "https://api.slideforge.dev/mcp/",
        "headers": {"Authorization": f"Bearer {API_KEY}"},
    }
})
tools = await client.get_tools()          # 7 SlideForge tools, ready for any agent

# ...or use them directly, no LLM required:
result = await {t.name: t for t in tools}["create_slide"].ainvoke({
    "form": "kpi_metrics",
    "headline": "Q3 at a glance",
    "data": {"metrics": [
        {"label": "Revenue", "value": "\$12.4M", "delta": "+18% YoY"},
        {"label": "New clients", "value": "847"},
        {"label": "NPS", "value": "62"},
    ]},
})

Drop tools straight into a LangGraph agent:

from langgraph.prebuilt import create_react_agent
agent = create_react_agent(model, tools)

LlamaIndex

pip install llama-index-tools-mcp
from llama_index.tools.mcp import BasicMCPClient, aget_tools_from_mcp_url

URL = "https://api.slideforge.dev/mcp/"
client = BasicMCPClient(URL, headers={"Authorization": f"Bearer {API_KEY}"})

tools = await aget_tools_from_mcp_url(URL, client=client)
# keep the agent's context small — load only what you need:
tools = await aget_tools_from_mcp_url(
    URL, client=client, allowed_tools=["browse_catalog", "plan_slide", "create_slide"]
)

Then hand tools to a FunctionAgent (see the example file).

What you get

ToolUseCost
create_slideOne slide from a typed intent (form + fields) or a brief$0.05
create_deckWhole deck, rendered in parallelN × $0.05
plan_slideBrief → best form/variant, creates nothingFree
browse_catalog200+ layouts + their exact payload schemasFree
translate_deck · upload_asset · manage_accountLocalize · assets/PDF→deck · wallet & jobsvaries

Let the agent discover the layout: plan_slide and browse_catalog are free, so an agent can find the right form before it spends anything. dry_run: true validates a payload at $0.

Reading the response

Every render returns the honesty layer — build your agent's control flow on it, not on a screenshot:

{"job_id": "...", "status": "complete", "fidelity": "verbatim",
 "pptx_available": true, "editability": {"editable_percentage": 100}}
  • fidelity: verbatim — your values were placed exactly as supplied.
  • status: rejected with errors[] — nothing rendered and nothing billed (e.g. too few data points for the form). Fix the payload and retry.
  • Download: GET /v1/jobs/{job_id}/pptx with the same Authorization header.

Notes

  • No SlideForge SDK. These adapters talk to the MCP server directly; there's nothing extra to keep in sync. tools/list is unauthenticated, tool calls need the key.
  • Prefer a local stdio process? pip install slideforge-mcp (see the repo README).
  • Full tool reference: slideforge.dev/docs/mcp.