slideforge-mcp 5.5.1__tar.gz

slideforge_mcp-5.5.1/.claude-plugin/marketplace.json

@@ -0,0 +1,22 @@
+{
+  "name": "slideforge-mcp",
+  "owner": {
+    "name": "Smart Data Brokers GmbH",
+    "email": "hello@slideforge.dev"
+  },
+  "metadata": {
+    "description": "Official SlideForge plugins — deterministic PowerPoint generation for AI agents (slideforge.dev)",
+    "version": "5.1.0"
+  },
+  "plugins": [
+    {
+      "name": "slideforge",
+      "description": "SlideForge remote MCP server config + skills: create editable .pptx from typed intents (fidelity manifest, usable-or-free), inspect/repair any deck, translate, PDF extract.",
+      "version": "5.1.0",
+      "source": {
+        "source": "github",
+        "repo": "smartdatabrokers/slideforge-mcp"
+      }
+    }
+  ]
+}

slideforge_mcp-5.5.1/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "slideforge",
+  "version": "5.1.0",
+  "description": "Official SlideForge integration: remote MCP server (streamable-http, OAuth or API key) + agent skills for slide/deck creation, deck inspect & repair, translation, and PDF extraction.",
+  "author": {
+    "name": "Smart Data Brokers GmbH",
+    "url": "https://slideforge.dev"
+  },
+  "keywords": ["powerpoint", "pptx", "slides", "presentations", "mcp", "deck", "reporting"],
+  "license": "MIT"
+}

slideforge_mcp-5.5.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug Report
+about: Report a problem with SlideForge MCP server setup or usage
+title: "[Bug] "
+labels: bug
+---
+
+**MCP Client**
+Which client are you using? (Claude Desktop, Claude Code, Cursor, Windsurf, other)
+
+**Auth Method**
+OAuth or API Key?
+
+**What happened?**
+A clear description of the bug.
+
+**Steps to reproduce**
+1. ...
+2. ...
+3. ...
+
+**Expected behavior**
+What should have happened.
+
+**Error messages**
+Paste any error messages or logs.
+
+**Additional context**
+- OS:
+- Client version:
+- Job ID (if applicable):

slideforge_mcp-5.5.1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,18 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+title: "[Feature] "
+labels: enhancement
+---
+
+**What would you like?**
+A clear description of the feature.
+
+**Why is this useful?**
+How would this help your workflow?
+
+**Alternatives considered**
+Any workarounds you've tried.
+
+**Additional context**
+Screenshots, examples, or references.

slideforge_mcp-5.5.1/.gitignore

@@ -0,0 +1,19 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+*.venv/
+
+# Test / tooling
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db

slideforge_mcp-5.5.1/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "slideforge": {
+      "type": "http",
+      "url": "https://api.slideforge.dev/mcp/"
+    }
+  }
+}

slideforge_mcp-5.5.1/AGENTS.md

@@ -0,0 +1,77 @@
+# 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 150+ 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):
+
+```bash
+# 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.
+
+## Rules
+
+- **Put real content in typed fields** (`data.*` per the form schema), not prose into a brief,
+  whenever the content matters — typed input binds verbatim and forecasts `fidelity: verbatim`.
+  Numbers render verbatim; the deterministic path makes zero external model calls.
+- **Never retry an identical failed payload** — fix what the error's `remedy` says. Identical
+  *successful* input re-renders free (`repeat_of`), so idempotent retries are safe on success.
+- **Decks:** one `create_deck` call, not N `create_slide` calls — parallel render, one merged
+  pptx, per-slide manifest rollup.
+- **Branding: upload the user's own template.** `upload_asset(purpose="theme", data=<base64
+  .pptx>)` renders NATIVE by default — the deck is built ON their template file (master,
+  layouts, fonts), not a color-matched imitation. `create_slide(form="template_layout", ...)`
+  fills the template's own designed cover/agenda/divider slides verbatim.
+- **Client demands a minimum font size?** Pass `min_font_pt` (typical ask: 12). It is BINDING:
+  type grows to meet the floor where the box allows; content that cannot fit returns a $0
+  `min_font_not_met` error naming the size it actually needs — set `allow_truncation: true`
+  to render the subset that fits (`fidelity: verbatim_truncated`) instead.
+- **Layouts the catalog can't express:** `mode=code` (sandboxed python-pptx + a widget/chart
+  helper toolkit — list it via `browse_catalog type=widgets`). Still $0.05, still deterministic.
+- **Check any existing deck for free:** `POST /v1/inspect` (REST) returns a Deck Quality Report
+  for any pptx — overflow (real font metrics), content hidden behind shapes, off-canvas
+  leftovers, WCAG contrast, hidden slides. `POST /v1/repair` applies deterministic fixes
+  (never alters words; $0.02 per repaired slide; `dry_run` = free exact quote).
+- **Transform:** `translate_deck` ($0.02/slide, 32 languages, formatting preserved);
+  `upload_asset purpose=pdf` extracts a PDF into editable intents ($0.01/page).
+- Costs are bounded and machine-readable (`GET /v1/pricing`); trial accounts start with
+  60 free slides. Never invent prices in user-facing summaries — read the rate card.
+
+## Files in this repo you can reuse
+
+- `skills/` — agent skills (SKILL.md standard) for Claude Code, Copilot, Cursor & friends:
+  `create-slide`, `inspect-repair`, `translate-pptx`, `pdf-to-pptx`.
+- `examples/` — client configs (Claude Desktop, Cursor) and the headless self-review loop.

slideforge_mcp-5.5.1/CHANGELOG.md

@@ -0,0 +1,216 @@
+# Changelog
+
+All notable changes to the SlideForge MCP server.
+
+## 5.5.1 — 2026-07-23
+
+- Dockerfile `CMD` is now `["python", "-m", "slideforge_mcp"]` (command + args) instead of the
+  bare console script, so container launchers that require a non-empty argument list — e.g.
+  Glama's deploy config ("At least one command argument is required") — accept it. Adds
+  `slideforge_mcp/__main__.py` so `python -m slideforge_mcp` runs the stdio server. Behaviour
+  is identical to `slideforge-mcp`.
+
+## 5.5.0 — 2026-07-23
+
+Adds a **local stdio MCP server** alongside the hosted remote endpoint. It's a thin REST
+client over `api.slideforge.dev` (holds no engine logic): the 7 tool schemas are baked in
+locally — so `tools/list` works with no network and no key — and each call forwards to the
+REST tool-dispatch endpoint (`POST /v1/tools/{name}`) authenticated with `SLIDEFORGE_API_KEY`.
+
+- For clients that boot MCP servers from a container/stdio, and for offline schema discovery.
+- Most agents should keep using the hosted remote server (`https://api.slideforge.dev/mcp/`,
+  OAuth 2.1 or API key) — no install. See the README "Run it locally" section.
+- Ships `pyproject.toml` (console entry `slideforge-mcp`), a Python package under
+  `src/slideforge_mcp/`, a contract snapshot (`contract/tools_list.prod.json`) captured
+  verbatim from prod, and a contract-parity test that fails if the wrapper drifts from the
+  served surface.
+- Replaces the previous `mcp-remote`-based Dockerfile (which registries reject as a proxy)
+  with one that builds and runs the local server.
+
+## 5.4.0 — 2026-07-21
+
+Syncs the repo to the served surface (service v5.104.0).
+
+### Payload grammar
+- Stat prominence: list/workflow block items accept `metric: {value, label}` — renders as a
+  stat column. Numeric fields want finite bare numbers (no % signs, units, currency symbols).
+- Layer stacks: `orientation: "horizontal"` (left-to-right pipeline, crossing control rails)
+  and per-component `state: current|target|gap` capability-heat tinting.
+- `quality_profile` (executive/technical/appendix) answers on any form; measurement only.
+
+### Contract honesty
+- `dry_run` validated responses carry explicit next-step text; unknown intent fields warn
+  (`field_ignored`) instead of vanishing; Gantt validates period + dependency references;
+  matrix rows validate cell cardinality; a `display_shrink` warning fires when a
+  display-scale design renders far below its intended size.
+- Brief-routed fills may switch to a sibling variant when the fill's structure check
+  disagrees with retrieval (`ai_completed` provenance, disclosed in the response meta).
+
+### Rendering
+- Consultant-grade structural upgrades across architecture diagrams: contained numbered
+  layer stacks with solid control rails, continuous funnels, true staircase climbs with
+  tinted maturity bands, nested-ring qualifiers, typed flow-node icons.
+- Uploaded brand templates: native emit now clears the template's own footer chrome and
+  header zones (per-template regression harness behind it).
+
+## 5.3.0 — 2026-07-18
+
+Syncs the repo to the served surface (service v5.90.1).
+
+- **`min_font_pt`** on `create_slide` (and per-slide in `create_deck`): a BINDING minimum type
+  size, 6–40pt. Text is never shrunk below the floor — it GROWS to meet it where the box allows;
+  most catalog forms adapt to a 12pt ask dynamically. Content that cannot fit at the floor is a
+  $0 `min_font_not_met` error naming the size it actually needs; `allow_truncation: true`
+  renders the fitting subset (`fidelity: verbatim_truncated`, item-granular — never chopped
+  words). Chart/axis furniture is judged on its own floor, so dense exhibits stay expressible.
+- **Per-variant payload contracts**: `browse_catalog type=schema` + `variant=` returns that
+  variant's exact machine-readable contract (JSON Schema, capacity, field mapping, worked
+  example) — and every advertised example is now guaranteed to bind with nothing silently
+  dropped (contract tests anchor examples against the render, not against themselves).
+- **Fidelity forecast honesty**: `dry_run` no longer labels a `blocks` payload ignored when the
+  binder's compatibility fallback binds it; `input_shape_hint` warnings steer toward each
+  form's canonical `data.*` shape.
+
+## 5.2.0 — 2026-07-15
+
+Syncs the repo to the served surface (service v5.81.0). Three engineering arcs landed since 5.1.0,
+each validated by an external retest (5.5 → 8.2/10):
+
+- **`mode=safe`**: validate-then-render in ONE call — renders and bills only if faithful, otherwise
+  a $0 invalid report with the fix. The recommended default over the dry_run round-trip.
+- **Code-mode trust contract**: intent fields (`headline`/`context`/`takeaway`/`source_note`) render
+  as deterministic chrome around your `build(prs, slide)`; `verify` tiers (`lint` default,
+  `lint+vlm` visual second-look); helper geometry contracts reject impossible dimensions with exact
+  numbers; code renders carry the same `status`/`warnings[]`/`errors[]` vocabulary and a measured
+  `layout` readiness block. Code-mode slides are first-class deck children.
+- **Quality profiles**: `quality_profile` (executive | technical | appendix) sets the readiness bar
+  `layout.presentation_ready` is judged against — measurement only, never blocks or re-prices.
+- **Complex-diagram robustness**: connector-routing/label solver kernel for flows, org charts,
+  swimlanes; capacity contracts on relationship-heavy forms (over-dense content is refused honestly
+  with a decomposition plan rather than rendered unreadable); six decomposition strategies.
+- **Routing controls**: `variant_policy` (production_safe), literal `candidate_margin`, calibrated
+  `route.confidence` with honest labels; decisive routes never read as ambiguity.
+- **Honest-by-default flags**: `allow_fabrication` / `allow_truncation` / `allow_low_confidence` —
+  the server rejects at $0 rather than guessing, unless you opt in.
+
+## 5.1.0 — 2026-07-08
+
+- **Native brand-template rendering**: `upload_asset(purpose="theme", data=<base64 .pptx>)`
+  renders NATIVE by default — the output deck is built ON the client's own template file
+  (master, layouts, fonts intact), not a color-matched imitation. Responses carry
+  `brand_fidelity_level: "native"`.
+- **Drag/drop theme upload**: omit `data` on a large theme file and the result card shows a
+  drop zone — bytes never pass through the agent.
+- **Branded furniture layouts**: `create_slide(form="template_layout", theme_id=..., data=...)`
+  fills the template's own designed cover/agenda/section-divider/closing slides verbatim,
+  deterministic and LLM-free. Discoverable via `browse_catalog(type="themes", theme_id=...)`.
+- **Translation: 8 → 32 languages** (Latin, Cyrillic, and Greek scripts; no CJK/RTL yet), both
+  REST and MCP.
+- **Security hardening**: tool result bodies are now credential-free (no signed URLs); the
+  .pptx downloads via header-auth (`Authorization: Bearer` + ownership check);
+  `POST /v1/jobs/<job_id>/download-url` mints a short-TTL single-use handoff link; artifacts
+  auto-delete after 30 days; every download is audit-logged;
+  `manage_account(action=security_status)` discloses the full posture in-band.
+- **New fidelity grade `partial`**: some supplied content did not make it onto the slide; the
+  manifest names what was dropped.
+
+## 5.0.0 — 2026-07-03
+
+The v5 surface (the engine consolidation shipped on the service earlier this year, now
+reflected here):
+
+- **7 served tools** (+2 enterprise-gated) — `browse_catalog` replaces `search_catalog`; `create_slide` is intent-first
+  (form + typed fields bind verbatim; `mode=code` remains); the creative/iterate/template
+  modes and per-mode pricing are gone. One price: $0.05/slide, usable-or-free.
+- **Fidelity manifest** on every response (verbatim | mixed | ai_completed) — the honesty layer.
+- **Deck Doctor**: free `POST /v1/inspect` (Deck Quality Report for any pptx) +
+  `POST /v1/repair` ($0.02/repaired slide, never alters words). New `inspect-repair` skill.
+- **Plugin marketplace**: `/plugin marketplace add smartdatabrokers/slideforge-mcp` installs
+  skills + the MCP server config (`.claude-plugin/`, `.mcp.json`).
+- **AGENTS.md** (portable, agents.md standard) + **CLAUDE.md** for agent-native onboarding.
+- Skills rewritten for the current surface; README/llms-install/examples refreshed.
+
+## [4.0.1] — 2026-04-22
+
+### Fixed
+- Tool annotation semantics corrected for Claude Connectors Directory
+  compliance: `destructiveHint=false` on create/translate/generate tools
+  (they create content, they don't destroy), `readOnlyHint=false` on
+  `manage_account` (feedback submission writes), `idempotentHint=true`
+  on `upload_asset` (safe to retry).
+- Response size cap added to every inline preview embed (2 MB raw bytes
+  / 1920px longest dim in "full" mode) so tool results stay under
+  Anthropic's 25K-token MCP limit.
+
+### Added
+- Three Claude Agent Skills in `skills/` — create-slide, translate-pptx,
+  pdf-to-pptx — mirroring the core MCP tools.
+
+## [4.0.0] — 2026-04-22
+
+### Added
+- Component Library v4: flagship primitives (CapabilityMap, ScatterBubble,
+  DecisionLog), composition as first-class path (Strategy on a Page,
+  Portfolio steering), chart semantics overhaul.
+
+### Changed
+- Component catalog rationalized: Tracker.scorecard removed (dup with
+  RAGScorecard), StakeholderMap alias removed (now aliased to OrgTree),
+  fabricated `quality_score` / `usage_count` stripped from catalog API.
+- Feature Grid template merged into Icon Grid (**breaking**: callers
+  using `feature_grid` should migrate to `icon_grid`).
+
+## [3.3.0] — 2026-04-21
+
+### Added
+- `ArchitectureStack` flagship primitive for enterprise architecture
+  decks — semantic zones (layers, externals, cross-cutting), three
+  opinionated styles (enterprise/data_ai/application), 10-code soft
+  validation via `architecture_warnings` envelope.
+- Three flagship templates (Architecture Overview, Data & AI Platform,
+  Application Integration Architecture).
+
+## [3.2.0] — 2026-04-20
+
+### Added
+- Public unauthenticated free-tier endpoint `POST /v1/tools/pdf-to-pptx`
+  — 25 MB / 15-page caps, 5 req/hour/IP rate limit, Tier-1 abuse
+  defense. Web UI at `/tools/pdf-to-pptx` with measured benchmark
+  (112-page deck → 18 s).
+
+## [2.0.0] — 2026-04-19
+
+### Changed
+
+- **Tool consolidation: 28 → 8 tools.** Fewer tools = faster agent discovery, less context overhead.
+- `create_slide` replaces render_slide, generate_slide, iterate_slide, render_spec, render_code, get_slide_status, suggest_layout, render_preflight. Uses `mode` param (auto/creative/spec/code/iterate/status).
+- `create_deck` replaces generate_deck, assemble_deck, fork_deck. Uses `mode` param (generate/assemble/fork).
+- `search_catalog` replaces list_templates, search_templates, suggest_template, list_components, search_components, list_themes. Uses `type` param (templates/components/themes).
+- `manage_account` replaces get_me, get_usage, list_jobs, submit_feedback, get_agent_onboarding, get_capabilities. Uses `action` param.
+- `upload_asset` replaces upload_file. Cleaner schema with `purpose` param (logo/theme/image).
+- `generate_report` now supports discovery mode (omit slug to list available report types).
+- Default `include_preview` changed from "none" to "default" — agents get inline previews automatically.
+
+### Added
+
+- Spec iteration: `create_slide(mode=iterate)` now works on spec-rendered slides (was broken pre-v2.6.3).
+- `_to_emu()` helper: shape helpers accept both `Inches()` and float values — no more double-wrapping bugs.
+- `_segment_color()`: chart segments (stacked bars, donuts) use distinct primary/accent colors.
+- Template enrichment: auto-routed templates enrich sparse briefs before param extraction.
+
+### Fixed
+
+- 12 quality bugs from v2.6.3-v2.6.5 test report (metric delta, tracker value, donut labels, etc.)
+
+## [1.0.0] — 2026-03-31
+
+### Available
+
+- 13 MCP tools (later expanded to 28 before consolidation)
+- 2 MCP prompts: `create_presentation`, `quick_slide`
+- OAuth 2.1 authentication (Claude Desktop native)
+- API key authentication (all MCP clients)
+- 39 built-in consulting templates
+- Custom brand themes
+- Inline PNG preview
+- Free trial on signup (today: 60 free slides)

slideforge_mcp-5.5.1/CLAUDE.md

@@ -0,0 +1,12 @@
+@AGENTS.md
+
+# Claude Code specifics
+
+- Install the server: `claude mcp add --transport http slideforge https://api.slideforge.dev/mcp/`
+- Install the skills as a plugin: `/plugin marketplace add smartdatabrokers/slideforge-mcp`
+  then `/plugin install slideforge@slideforge-mcp` — or copy folders from `skills/` into
+  `~/.claude/skills/`.
+- Responses have no inline widgets here, but the tool result embeds the preview PNG inline —
+  read it straight out of the response to check a render before declaring it done. Download
+  the .pptx via header-auth: `GET /v1/jobs/<job_id>/pptx` with
+  `Authorization: Bearer sf_live_YOUR_KEY`.

slideforge_mcp-5.5.1/Dockerfile

@@ -0,0 +1,31 @@
+# SlideForge local stdio MCP server — a real MCP server that runs locally over stdio.
+# It bakes the tool schemas in (so `tools/list` works with no network and no key) and
+# forwards tool calls to the SlideForge REST API (https://api.slideforge.dev) using an
+# API key. NOT an mcp-remote proxy: the MCP protocol is served locally.
+#
+# Provide SLIDEFORGE_API_KEY (an sf_live_... key from https://slideforge.dev) at run time
+# to make tool calls. Schema discovery needs neither a key nor network.
+FROM python:3.12-slim
+
+RUN pip install --no-cache-dir uv
+
+WORKDIR /app
+
+# Install deps first for layer caching, then the package.
+COPY pyproject.toml README.md ./
+COPY src ./src
+RUN uv pip install --system --no-cache .
+
+# Non-root.
+RUN useradd -m appuser
+USER appuser
+
+ENV PYTHONUNBUFFERED=1 \
+    SLIDEFORGE_API_BASE="https://api.slideforge.dev" \
+    SLIDEFORGE_API_KEY=""
+
+# Launch the stdio MCP server (single process, JSON-RPC over stdin/stdout).
+# Use `python -m` (command + args) so launchers that require a non-empty argument
+# list — e.g. Glama's deploy config — accept it. `slideforge-mcp` (the console script)
+# is equivalent.
+CMD ["python", "-m", "slideforge_mcp"]

slideforge_mcp-5.5.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Smart Data Brokers GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.