Generates complete App Store and Google Play screenshot sets with procedural device frames, backgrounds, and localization from raw app screenshots.
Also known as antonkarliner/truepane, truepane-mcp
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.1
- Last commit
- Aug 21, 2026
- License
- AGPL-3.0
What is truepane MCP?
truepane generates complete App Store and Google Play screenshot sets with procedural device frames, backgrounds, and localization from raw app screenshots.
Summary generated from the project's README
About truepane MCP server
Transforming raw mobile app screenshots into professional App Store and Google Play marketing assets is what truepane enables for developers using AI agents. By connecting this local MCP server to clients like Claude Code, Cursor, or Windsurf, you can automate the creation of complete screenshot sets including procedural device frames, custom backgrounds, and localized typography. The server handles complex layouts such as spanning a single device across two adjacent slides or applying continuous backgrounds that flow across an entire strip.
Everything runs entirely on your local machine using a native canvas, meaning your screenshots are read from and written to local file paths without any data being uploaded to a cloud service. No API keys or external configurations are required because the AI agent itself manages the styling and translation decisions. You can use tools like set_style to adjust device rotation, scale, and position, or use suggest_palette_from_screenshot to automatically derive a color scheme from your app's visuals. The system supports various outputs including native store sizes, Google Play feature graphics, and custom dimensions.
What you can do with it
- 1Generate multi-platform marketing setsCreate a complete collection of screenshots for iPhone, iPad, and Android devices with specific localizations.
- 2Manage visual brand consistencySave and reuse your specific brand styles and typography across different projects without moving large files.
Written from the project's README. Every use case is checked against a quote from it.
How to install truepane MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall truepane MCP in Claude Code
$ claude mcp add truepane -- npx -y truepane-mcpInstall truepane MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"truepane": {
"command": "npx",
"args": [
"-y",
"truepane-mcp"
]
}
}
}Install truepane MCP in VS Code
.vscode/mcp.json
{
"servers": {
"truepane": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"truepane-mcp"
]
}
}
}Install truepane MCP in VS Code CLI
$ code --add-mcp '{"name":"truepane","type":"stdio","command":"npx","args":["-y","truepane-mcp"]}'Install truepane MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"truepane": {
"command": "npx",
"args": [
"-y",
"truepane-mcp"
]
}
}
}Install truepane MCP in Codex
$ codex mcp add truepane -- npx -y truepane-mcpInstall truepane MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.truepane] command = "npx" args = ["-y", "truepane-mcp"]
Install truepane MCP in Gemini CLI
$ gemini mcp add -s user truepane npx -- -y truepane-mcpInstall truepane MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"truepane": {
"command": "npx",
"args": [
"-y",
"truepane-mcp"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableantonkarliner/truepane is public and reachablegithub.com/antonkarliner/truepane ↗Pass
- Package names this repository as its sourcetruepane-mcp names antonkarliner/truepane as sourcenpmjs.com/package/truepane-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-21github.com/antonkarliner/truepane ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from truepane-mcpPass
- No critical advisory in the package or its dependencies111 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- 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 GitHubtruepane-mcp
A local MCP server for Truepane. It lets an AI agent (Claude Code, Codex, …) take raw app screenshots — e.g. captured from a simulator — and turn them into store-ready App Store / Google Play slides: procedural device frames at exact store resolutions, generated backgrounds, typography, and per-language localization.
Everything runs locally. It renders with a native canvas
(@napi-rs/canvas): screenshots are read from local file paths and PNGs are
written to local file paths — nothing is uploaded anywhere. No configuration
or API keys are needed. The agent is itself the language model, so styling and
translation are its own judgment calls.
What agents can do
- Build one project for iPhone, iPad, Android phone, and Android tablet, with target- and locale-specific screenshots.
- Preview and apply a screenshot directory deterministically with
import_screenshots; conflicts never overwrite silently. - Place text and devices with normalized coordinates, resize mockups, align copy, rotate devices from −20° to +20°, and tilt the text block from −12° to +12°.
- Set a custom background image per slide, across every slide, or as one long
backdrop sliced across the whole strip, with
set_background_image. Tune opacity, scrim, and fit afterwards; a scrim keeps titles readable over a photo. A backdrop can also be derived from the slide's own screenshot, which costs no storage at all. - Compose backgrounds parametrically with the
customshape family: six primitives (ring, disc, arc, triangle, bar, blob) across five arrangements (scatter, grid, row, radial, wave), with size, jitter, rotation, spacing, phase, stroke, and an opacity ramp. It is data, not code — deterministic from a seed, safe to share in a project file, and laid out in strip-space so a multi-slide background flows continuously. - Span one synchronized device across two adjacent slides. Both clipped halves keep their screenshot, position, scale, and rotation linked.
- Save and apply portable brand kits without carrying screenshots or project data.
- Render native store sizes, the 1024×500 Google Play feature graphic, or bounded custom dimensions. Custom width and height are validated together and rejected rather than silently replaced or clamped.
- Run the same advisory release preflight as the browser editor.
- Save a release baseline, compare added/changed/unchanged/removed assets, and render only changed assets.
- Round-trip editable project JSON with the Truepane web editor.
Install
It's a standard stdio MCP server — any MCP-capable client can launch it with
npx -y truepane-mcp (no checkout required). Requires Node ≥ 18.
Claude Code
claude mcp add --scope user truepane -- npx -y truepane-mcp
Codex CLI
codex mcp add truepane -- npx -y truepane-mcp
Or configure Codex manually in ~/.codex/config.toml:
[mcp_servers.truepane]
command = "npx"
args = ["-y", "truepane-mcp"]
Cursor, Windsurf, Claude Desktop, and other JSON-config clients — add to the
client's mcpServers block:
{
"mcpServers": {
"truepane": { "command": "npx", "args": ["-y", "truepane-mcp"] }
}
}
Restart the client, then confirm that the Truepane tools are available.
Recommended agent workflow
- Call
list_optionsfirst. It returns the full capability map plus valid platforms, output surfaces, fonts, backgrounds, and composition presets. - Use
create_projectfor slide copy and optional screenshots. Passtargetsfor a multi-platform project. - Attach target/locale media with
set_screenshots, or preview a prepared directory withimport_screenshotsand explicitly apply the reviewed map. - Use
set_stylefor typography, colors, backgrounds, and composition. For a background photo or a strip-wide backdrop, callset_background_imagewith a local file first, then tune it viaset_style background.image. Withslide_index, composition is slide-specific; device position is normalized canvas space, scale is0.4..1.6, and rotation is−20..20.suggest_palette_from_screenshotprovides a local-math starting palette. - Use
span_device_across_slideswhen one linked device should cross an adjacent slide boundary. - Add localized copy and optional localized screenshots with
set_translations. Renderlanguage: "all"for locale subfolders. - Call
validate_project, thenrenderand inspect its inline preview. Adjust and re-render until the set is ready. - Use
export_project/load_projectfor browser-editor handoff.
Tool map
| Goal | Tools |
|---|---|
| Create and edit content | create_project, set_slides, set_screenshots, set_translations |
| Bulk and multi-target media | import_screenshots, set_screenshots |
| Style and composition | set_style, suggest_palette_from_screenshot, span_device_across_slides |
| Background imagery | set_background_image, set_style with background.image |
| Reusable visual systems | export_brand_kit, apply_brand_kit |
| Native, feature, and custom canvases | set_output, render |
| Release safety | validate_project, compare_release, set_release_baseline, render with changed_only |
| Web-editor handoff | export_project, load_project |
render writes full-resolution PNGs and returns a compact inline preview.
Use target: "all" and/or language: "all" for the full matrix. Use
what: "strip" for a continuous horizontal strip.
Fonts
Google Fonts are fetched on demand and cached in ~/.cache/truepane/fonts
(Inter is bundled, so offline rendering works out of the box). The
-apple-system font renders as real San Francisco on macOS — from your own
installed system font, never bundled or redistributed — and falls back to Inter
on Linux/CI. SF is a variable font, so its full weight range resolves (including
Heavy/Black via titleWeight/subtitleWeight), not just Regular/Bold. A curated
set of Google fonts — Inter, Manrope, and Fraunces — is loaded as a
single-file variable font too, so their full range resolves as well; other Google
fonts use their static faces (up to ~700). Want another font's full range? Open an
issue or PR adding it to VARIABLE_FONT_URLS in server/mcp/fonts.ts. For non-Latin
target languages, pick a font that covers the script (Inter covers
Cyrillic/Greek; Noto Sans JP/KR/SC for CJK; Noto Sans Arabic for Arabic,
which is shaped and laid out right-to-left automatically) — unlike browsers,
server-side rendering has no per-glyph system-font fallback, so glyphs a font
lacks come out as boxes.
License
AGPL-3.0. Part of the Truepane project; see the main repository for the web app and full documentation.
truepane MCP questions
How do I add truepane MCP to Claude Code?
Run claude mcp add truepane -- npx -y truepane-mcp in your terminal. Add --scope user to make it available in every project.
How do I add truepane MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need to upload my screenshots to a cloud service?
No, everything runs locally using a native canvas. Screenshots are read from and written to local file paths, so nothing is uploaded.
Does this server require any API keys to function?
No configuration or API keys are required to use the server.
Can I use custom backgrounds for my screenshots?
Yes, you can set custom background images per slide or across a whole strip, and even compose backgrounds using parametric shapes like rings, discs, and blobs.
How are fonts handled during rendering?
Google Fonts are fetched on demand and cached locally, while Inter is bundled for offline use. It also supports system fonts like San Francisco on macOS.