DeckForge MCP server
Commit Oct 26, 2026Generates professional PPTX and Google Slides decks from natural language prompts or structured JSON specifications using an AI-driven pipeline.
Also known as Whatsonyourmind/deckforge
- Stars
- 7
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 26, 2026
- License
- MIT
What is DeckForge MCP?
DeckForge generates professional PPTX and Google Slides decks from natural language prompts or structured JSON specifications using an AI-driven pipeline.
Summary generated from the project's README
About DeckForge MCP server
DeckForge provides an API-first pipeline for generating professional presentation decks from natural language prompts or structured JSON specifications. It is designed for developers and AI agents that need to produce high-quality PowerPoint or Google Slides files without managing local Office installations or complex layout code. The system supports 32 different slide types and 24 chart types, including specialized layouts for finance such as DCF summaries and waterfall charts.
Users can deploy the server locally using Docker Compose, which sets up the necessary API, workers, and databases. To generate content from text, the server requires an LLM API key from providers like Anthropic, OpenAI, Gemini, or Ollama. The platform includes a five-pass QA pipeline that automatically corrects issues with alignment, contrast, and text overflow. Developers can use the provided TypeScript SDK or direct API calls to manage themes, estimate costs, and render final documents.
What you can do with it
- 1Convert text to pitch decksAn AI agent can take a single sentence describing a business and turn it into a full presentation.
- 2Automate financial reporting slidesDevelopers can transform raw numerical data into specialized financial layouts like sensitivity tables or capital structures.
- 3Programmatic slide generation from JSONYou can send a structured intermediate representation to create themed decks with specific elements.
- 4Budgeting for autonomous agentsAn autonomous system can calculate the credit cost of a presentation before initiating the rendering process.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
DECKFORGE_ANTHROPIC_API_KEYDECKFORGE_DATABASE_URLDECKFORGE_DEBUGDECKFORGE_ENVIRONMENTDECKFORGE_REDIS_URLDECKFORGE_S3_ACCESS_KEYDECKFORGE_S3_BUCKETDECKFORGE_S3_ENDPOINT_URLDECKFORGE_S3_SECRET_KEYDECKFORGE_STRIPE_SECRET_KEYDECKFORGE_STRIPE_WEBHOOK_SECRET
| Name | Description | |
|---|---|---|
| DECKFORGE_ANTHROPIC_API_KEY | — | |
| DECKFORGE_DATABASE_URL | — | |
| DECKFORGE_DEBUG | — | |
| DECKFORGE_ENVIRONMENT | — | |
| DECKFORGE_REDIS_URL | — | |
| DECKFORGE_S3_ACCESS_KEY | — | |
| DECKFORGE_S3_BUCKET | — | |
| DECKFORGE_S3_ENDPOINT_URL | — | |
| DECKFORGE_S3_SECRET_KEY | — | |
| DECKFORGE_STRIPE_SECRET_KEY | — | |
| DECKFORGE_STRIPE_WEBHOOK_SECRET | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablewhatsonyourmind/deckforge is public and reachablegithub.com/whatsonyourmind/deckforge ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-26github.com/whatsonyourmind/deckforge ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubExecutive-ready slides, one API call away. Send a JSON intermediate representation (IR) or a natural-language prompt and get back a .pptx file or Google Slides deck -- with professional layout, consistent branding, and verified quality.
🚀 Using DeckForge in production — or want higher limits, priority support, or a specific slide/chart capability? Tell me about your use case → — I read every one.
What this solves
- Your agent needs to turn a structured slide spec into a real PowerPoint — without a headless Office install or hand-written python-pptx code. Send a Presentation IR (slides, elements, theme) to
renderand get a themed.pptx(or Google Slides) deck plus a quality score and a count of layout/QA issues. - Your agent needs a deck from a one-line prompt — without designing the narrative itself.
generateruns a 4-stage content pipeline (intent → outline → expand → refine) that picks slide types and writes content, returning a structured IR you can thenrender. - You need finance-flavored slides — without rebuilding DCF, comp-table, waterfall, or returns layouts every time. 9 finance slide types and finance-oriented chart types (waterfall, tornado, football field, sensitivity table) are first-class IR, so a model output of numbers becomes an auditable, themed slide.
- Your agent must choose valid
slide_type,theme, and chart values at runtime — without guessing.themes(15) andslide_types(32: 23 universal + 9 finance, with required/optional elements) are discovery tools that return the exact identifiers and element requirements to build correct IR. - You need a deterministic cost before spending on a render — without trial calls.
cost_estimatecomputes credits fromceil(slides/10)plus per-finance-slide and per-chart surcharges, returning a breakdown and USD equivalent so an autonomous agent can budget before it acts. - You want decks to be consistent and machine-checked — without a human design pass. Every render runs a QA pipeline with auto-fix for contrast, overflow, and alignment, and reports a
quality_scoreandqa_issuescount back to the caller.
Features
- 32 slide types -- title, agenda, bullet points, comparison, timeline, process flow, org chart, stats callout, table, chart, matrix, funnel, map, and more
- 9 finance-specific slides -- DCF summary, comp table, waterfall chart, deal overview, returns analysis, capital structure, market landscape, risk matrix, investment thesis
- 24 chart types -- bar, line, area, pie, donut, scatter, bubble, combo, waterfall, funnel, treemap, radar, tornado, football field, sensitivity table, heatmap, sankey, gantt, sunburst, and more
- 15 built-in themes -- corporate-blue, executive-dark, finance-pro, modern-gradient, minimal-light, tech-neon, and 9 others (plus custom brand kits)
- Native PPTX output -- python-pptx rendering with element-level control, transitions, and chart embedding
- Google Slides output -- direct export via Google Slides API (OAuth flow included)
- AI content generation -- natural-language to slides via Claude, OpenAI, Gemini, or Ollama (4-stage pipeline: intent, outline, expand, refine)
- 5-pass QA pipeline -- automated quality checks with auto-fix engine for contrast, overflow, alignment, and more
- Constraint-based layout -- kiwisolver constraint solver, 12-column grid, adaptive overflow (font reduce, reflow, split)
- MCP server -- 6 tools for AI agent integration (render, generate, themes, slide_types, cost_estimate, pricing)
- x402 payment middleware -- optional per-call USDC support (Base L2) for self-hosted deployments; disabled by default
- Billing infrastructure -- Stripe subscription + credit-system support for self-hosted deployments (no hosted paid plans are offered yet)
- TypeScript SDK --
@lukastan/deckforgewith fluent builder pattern, full type safety, SSE streaming
Quick Start
Get from zero to your first rendered deck in under 5 minutes.
Prerequisites
- Docker and Docker Compose
- Git
Steps
# 1. Clone the repo
git clone https://github.com/Whatsonyourmind/deckforge && cd deckforge
# 2. Copy environment config (works out of the box for local dev)
cp .env.example .env
# 3. Start all services (API, workers, PostgreSQL, Redis, MinIO)
docker compose up -d
# 4. Initialize the database (runs migrations, seeds test user + API key)
bash scripts/bootstrap-db.sh
# 5. Verify the API is running
curl http://localhost:8000/v1/health
# => {"status":"healthy"}
The bootstrap script outputs a test API key (dk_test_...). Save it for the examples below.
API Examples
Render a deck from IR
curl -X POST http://localhost:8000/v1/render \
-H "Authorization: Bearer dk_test_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"title": "Q4 Board Update",
"theme": "corporate-blue",
"slides": [
{
"slide_type": "title_slide",
"elements": [
{"type": "title", "content": "Q4 2026 Board Update"},
{"type": "subtitle", "content": "Acme Corp -- Confidential"}
]
},
{
"slide_type": "stats_callout",
"elements": [
{"type": "title", "content": "Key Metrics"},
{"type": "metric", "content": "$4.2M", "label": "ARR"},
{"type": "metric", "content": "142%", "label": "YoY Growth"},
{"type": "metric", "content": "94%", "label": "Retention"}
]
}
]
}' \
--output board-update.pptx
Generate a deck from natural language
curl -X POST http://localhost:8000/v1/generate \
-H "Authorization: Bearer dk_test_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Create a 10-slide pitch deck for a B2B SaaS startup in the cybersecurity space, Series A, $2M ARR",
"theme": "executive-dark",
"output_format": "pptx"
}' \
--output pitch-deck.pptx
Note: The
/v1/generateendpoint requires at least one LLM API key configured in.env(Anthropic, OpenAI, Gemini, or Ollama).
Check available themes and slide types
# List all 15 themes
curl http://localhost:8000/v1/themes
# List all 32 slide types with example IR
curl http://localhost:8000/v1/slide-types
# Estimate credit cost before rendering
curl -X POST http://localhost:8000/v1/estimate \
-H "Authorization: Bearer dk_test_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{"slides": [{"slide_type": "title_slide"}, {"slide_type": "chart_slide"}]}'
TypeScript SDK
Install from npm:
npm install @lukastan/deckforge
Fluent builder with full type safety:
import { DeckForge, Presentation, Slides } from "@lukastan/deckforge";
const client = new DeckForge({ apiKey: "dk_test_YOUR_KEY_HERE" });
const deck = Presentation.create("Q4 Board Update", "corporate-blue")
.addSlide(
Slides.titleSlide({
title: "Q4 2026 Board Update",
subtitle: "Acme Corp -- Confidential",
})
)
.addSlide(
Slides.statsCallout({
title: "Key Metrics",
metrics: [
{ value: "$4.2M", label: "ARR" },
{ value: "142%", label: "YoY Growth" },
{ value: "94%", label: "Retention" },
],
})
);
const pptx = await client.render(deck);
// => Buffer containing .pptx file
Generate from a prompt with SSE streaming:
const stream = client.generate({
prompt: "Create a PE deal memo for a $500M LBO of a healthcare platform",
theme: "finance-pro",
});
for await (const event of stream) {
console.log(`${event.stage}: ${event.message}`);
}
// intent: Analyzing prompt for presentation structure...
// outline: Creating 12-slide deal memo outline...
// expand: Generating slide content...
// refine: Running QA pipeline (5 passes)...
// complete: Deck ready for download
Architecture
+------------------+
| Clients |
| (curl/SDK/MCP) |
+--------+---------+
|
+--------v---------+
| FastAPI (uvicorn)|
| /v1/* routes |
| Auth + Rate Limit|
| Credit Billing |
+--+-----+------+--+
| | |
+-----------+ | +----------+
| | |
+--------v------+ +------v--------+ +------v--------+
| Content Worker | | Render Worker | | Sync Path |
| (ARQ + Redis) | | (ARQ + Redis) | | (< 10 slides) |
| NL -> IR | | IR -> PPTX | | Direct return |
+--------+------+ +------+--------+ +------+--------+
| | |
v v v
+--------+------+ +------+---------+ +-----+--------+
| LLM Adapters | | PPTX Renderer | | Google Slides|
| Claude/GPT/ | | Layout Engine | | Renderer |
| Gemini/Ollama | | Theme Resolver | | (OAuth) |
+---------------+ | Chart Renderer | +--------------+
| QA Pipeline |
+------+---------+
|
+------v---------+
| Storage |
| MinIO (dev) |
| R2/S3 (prod) |
+----------------+
+----------------+ +----------------+
| PostgreSQL | | Redis |
| Users, Keys | | Queue, Cache |
| Jobs, Decks | | Rate Limits |
| Billing | | SSE Pub/Sub |
+----------------+ +----------------+
API Routes
All routes are mounted under the /v1 prefix. Interactive docs at http://localhost:8000/docs.
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/v1/health |
GET | No | Health check |
/v1/render |
POST | API key | Render IR to PPTX/Google Slides |
/v1/generate |
POST | API key | Generate slides from natural language |
/v1/preview |
POST | API key | Generate thumbnail PNGs |
/v1/estimate |
POST | API key | Estimate credit cost |
/v1/jobs/{id} |
GET | API key | Check async job status |
/v1/themes |
GET | No | List available themes |
/v1/slide-types |
GET | No | List slide types with examples |
/v1/decks |
GET/POST/DELETE | API key | Deck CRUD operations |
/v1/batch |
POST | API key | Batch render multiple decks |
/v1/webhooks |
GET/POST/DELETE | API key | Manage webhook subscriptions |
/v1/billing/* |
Various | API key | Stripe subscription management |
/v1/pricing |
GET | No | Current pricing and tier info |
/v1/onboard/signup |
POST | No | Create account and API key |
/v1/analytics/* |
GET | Admin | Usage analytics and metrics |
/v1/auth/google/* |
GET | API key | Google OAuth flow for Slides |
Environment Variables
All variables are prefixed with DECKFORGE_. See .env.example for the complete reference with comments and example values.
| Variable | Default | Description |
|---|---|---|
DECKFORGE_DATABASE_URL |
postgresql+psycopg://...localhost |
PostgreSQL connection string |
DECKFORGE_REDIS_URL |
redis://localhost:6379/0 |
Redis connection (queue, cache, pub/sub) |
DECKFORGE_S3_ENDPOINT_URL |
http://localhost:9000 |
S3-compatible storage endpoint |
DECKFORGE_S3_ACCESS_KEY |
minioadmin |
S3 access key (MinIO default for dev) |
DECKFORGE_S3_SECRET_KEY |
minioadmin |
S3 secret key |
DECKFORGE_S3_BUCKET |
deckforge |
S3 bucket name |
DECKFORGE_API_HOST |
0.0.0.0 |
API bind address |
DECKFORGE_API_PORT |
8000 |
API port |
DECKFORGE_DEBUG |
true |
Debug mode (disable in production) |
DECKFORGE_ENVIRONMENT |
development |
development / staging / production |
DECKFORGE_LLM_DEFAULT_PROVIDER |
claude |
Default LLM for content generation |
DECKFORGE_LLM_FALLBACK_CHAIN |
claude,openai,gemini |
LLM fallback order |
DECKFORGE_ANTHROPIC_API_KEY |
-- | Anthropic API key for Claude |
DECKFORGE_OPENAI_API_KEY |
-- | OpenAI API key |
DECKFORGE_GEMINI_API_KEY |
-- | Google Gemini API key |
DECKFORGE_OLLAMA_BASE_URL |
http://localhost:11434 |
Ollama local server URL |
DECKFORGE_STRIPE_SECRET_KEY |
-- | Stripe secret key |
DECKFORGE_STRIPE_WEBHOOK_SECRET |
-- | Stripe webhook signing secret |
DECKFORGE_STRIPE_STARTER_PRICE_ID |
-- | Stripe price ID for Starter tier |
DECKFORGE_STRIPE_PRO_PRICE_ID |
-- | Stripe price ID for Pro tier |
DECKFORGE_GOOGLE_CLIENT_ID |
-- | Google OAuth client ID (for Slides) |
DECKFORGE_GOOGLE_CLIENT_SECRET |
-- | Google OAuth client secret |
DECKFORGE_GOOGLE_REDIRECT_URI |
http://localhost:8000/v1/auth/google/callback |
OAuth redirect URI |
DECKFORGE_UNKEY_ROOT_KEY |
-- | Unkey root key (production auth) |
DECKFORGE_UNKEY_API_ID |
-- | Unkey API ID |
DECKFORGE_X402_ENABLED |
false |
Enable x402 USDC payments |
DECKFORGE_X402_WALLET_ADDRESS |
-- | USDC receiving wallet on Base |
DECKFORGE_X402_FACILITATOR_URL |
https://x402.org/facilitator |
x402 facilitator endpoint |
DECKFORGE_X402_NETWORK |
eip155:8453 |
Base Mainnet chain ID |
Deployment
Render (recommended)
The hosted production API runs on Render at https://deckforge-api.onrender.com. DeckForge ships a render.yaml blueprint:
- In the Render dashboard choose New → Blueprint and point it at this repo — Render reads
render.yaml(web service + worker + managed Postgres + Redis). - Set production secrets (Stripe / Anthropic / S3) in the service's Environment tab, then trigger the first deploy.
# Verify
curl https://deckforge-api.onrender.com/v1/health
Fly.io (alternative)
DeckForge also ships a production-ready fly.toml and multi-stage Dockerfile.
# 1. Install Fly CLI
curl -L https://fly.io/install.sh | sh
# 2. Login and launch
fly auth login
fly launch --name deckforge-api --region iad
# 3. Provision PostgreSQL
fly postgres create --name deckforge-db --region iad
fly postgres attach deckforge-db
# 4. Provision Redis (via Upstash or Fly Redis)
fly redis create --name deckforge-redis
# Copy the REDIS_URL from output
# 5. Set production secrets
fly secrets set \
DECKFORGE_ENVIRONMENT=production \
DECKFORGE_DEBUG=false \
DECKFORGE_DATABASE_URL="postgres://..." \
DECKFORGE_REDIS_URL="redis://..." \
DECKFORGE_S3_ENDPOINT_URL="https://..." \
DECKFORGE_S3_ACCESS_KEY="..." \
DECKFORGE_S3_SECRET_KEY="..." \
DECKFORGE_S3_BUCKET="deckforge" \
DECKFORGE_STRIPE_SECRET_KEY="sk_live_..." \
DECKFORGE_STRIPE_WEBHOOK_SECRET="whsec_..." \
DECKFORGE_ANTHROPIC_API_KEY="sk-ant-..."
# 6. Deploy
fly deploy
# 7. Run database migrations
fly ssh console -C "alembic upgrade head"
# 8. Verify
curl https://<your-app>.fly.dev/v1/health
Fly.io configuration highlights:
- 2 shared CPUs, 1 GB RAM per VM
- Auto-stop/start for cost efficiency (min 1 machine running)
- Forced HTTPS with concurrency limits (200 soft / 250 hard)
- Multi-process:
api(uvicorn) +worker(ARQ)
Docker Compose (Local Development)
# Start all 6 services
docker compose up -d
# Services:
# api - FastAPI + uvicorn (port 8000)
# content-worker - ARQ worker for NL-to-IR generation
# render-worker - ARQ worker for IR-to-PPTX rendering
# postgres - PostgreSQL 16 (port 5432)
# redis - Redis 7 (port 6379)
# minio - MinIO S3-compatible storage (port 9000, console 9001)
# Check service health
docker compose ps
# View API logs
docker compose logs -f api
# Tear down (preserves data volumes)
docker compose down
# Full reset (removes data)
docker compose down -v
S3 Storage Options
| Environment | Provider | Config |
|---|---|---|
| Local dev | MinIO (via Docker Compose) | Default .env.example values |
| Production | Cloudflare R2 | Set S3_ENDPOINT_URL, S3_ACCESS_KEY, S3_SECRET_KEY |
| Production | AWS S3 | Set S3_ENDPOINT_URL to AWS endpoint |
| Fly.io | Fly Tigris | fly storage create, auto-configured |
Pricing
Pricing is not yet available — there are no paid plans you can purchase today. Want a hosted or commercial version, higher limits, or priority support? Join Early Access →
The billing code in this repo (Stripe subscriptions, credit system, x402 USDC middleware) is infrastructure for self-hosted deployments and is disabled by default.
Credit Cost (engine mechanics)
Each API call consumes credits based on complexity:
- Simple render (< 5 slides): 1 credit
- Standard render (5-20 slides): 2-3 credits
- Complex render (charts, finance slides): 3-5 credits
- Content generation (NL-to-IR): +2 credits (LLM usage)
Demo Decks
Five production-quality demo IRs in demos/:
| Demo | Slides | Theme | Use Case |
|---|---|---|---|
| McKinsey Strategy | 12 | corporate-blue | Strategy consulting deck |
| PE Deal Memo | 10 | finance-pro | Private equity investment committee |
| Startup Pitch | 12 | modern-gradient | Series A fundraising |
| Board Update | 8 | executive-dark | Quarterly board meeting |
| Product Launch | 10 | tech-neon | Product launch announcement |
Render any demo:
curl -X POST http://localhost:8000/v1/render \
-H "Authorization: Bearer dk_test_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d @demos/mckinsey-strategy/ir.json \
--output mckinsey-strategy.pptx
Integrations
MCP Server (AI Agents)
DeckForge includes a Model Context Protocol server with 6 tools:
{
"mcpServers": {
"deckforge": {
"command": "python",
"args": ["-m", "deckforge.mcp.server"]
}
}
}
Tools: render, generate, themes, slide_types, cost_estimate, pricing
Agent Framework Support
- LangChain -- render + generate tool classes
- CrewAI -- unified tool with action parameter
- AutoGen -- plain function tools with
Annotatedtypes
See demos/ for integration examples.
Links
- TypeScript SDK (
@lukastan/deckforge) - API Docs (interactive)
- API Status
- GitHub Issues
Contributing
- Fork the repo
- Create a feature branch (
git checkout -b feature/my-feature) - Run tests (
pytestfor Python,cd sdk && npm testfor TypeScript) - Commit and push
- Open a Pull Request
License
DeckForge MCP questions
What formats can DeckForge export to?
The engine supports native PPTX output and direct export to Google Slides via the Google Slides API.
Does it support finance-specific slide layouts?
Yes, it includes 9 finance-specific slide types and specialized chart types like waterfall, tornado, and football field charts.
Can I estimate the cost before generating a deck?
Yes, the cost_estimate tool computes credits based on slide count and specific surcharges for finance slides or charts.
How does the AI content generation work?
It uses a 4-stage content pipeline consisting of intent, outline, expand, and refine stages.