Tuval Studio MCP server
io.github.ariferol01/tuval-studio·v1.0.7Tuval Studio MCP: Graphic design, AI design & PDF catalog generator for Claude, Cursor & AI agents.
0 stars107 downloads/wk
Reviews
Write oneNobody has reviewed Tuval Studio yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Tuval Studio tools (53, 9 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
assets_list_localScans and lists all local images, icons, logos, and graphic assets in the workspace-assets directory ready to be placed onto the canvas.
assets_list_patternsLists all built-in geometric pattern and texture background presets (Dot Matrix, Technical Blueprint, Carbon Fiber, Diagonal Stripes, 3D Isometric Wireframe, Topography, Circuit Board).
assets_list_stickersLists all available built-in SVG stickers, badges, and vector elements available for insertion.
assets_list_stock_pngsLists free transparent 3D cutout assets, holographic spheres, lighting flares, and curated royalty-free photography available for instant placement.
assets_load_from_pathReads any local image or graphic file from the user computer (absolute path e.g. "C:/Users/name/Desktop/logo.png" or relative path), encodes it to Base64, and returns the data URL for use in canvas.
brush_drawwrite actionExecutes freehand brush drawing on the canvas with specific brush style ("pencil", "spray", "circle", "eraser"), color, size, and path coordinates.
canvas_clearClears all layers and objects from the canvas.
canvas_create_newwrite actionCreates a new blank canvas with specific dimensions and background color.
canvas_load_templateLoads a pre-designed layout template onto the canvas (e.g. "social-launch", "neon-sale-story", "youtube-thumbnail", "minimal-post", "bold-thumbnail").
canvas_set_backgroundSets the solid background color or enables alpha transparency. NOTE FOR AI DESIGNERS: You are NOT restricted to solid colors! You can search & apply rich background photography, architectural textures, gradients, or pattern grids using "image_add" with { isBackground: true }, or choose from "assets_list_patterns" / "assets_list_stock_pngs" / "assets_list_local".
canvas_set_dimensionsChanges the dimensions or applies a social media preset (1080x1080 Instagram Post, 1080x1920 Story, 1280x720 YouTube Thumbnail, 1200x630 Facebook/Web Banner).
canvas_set_gradientApplies a modern gradient to the canvas background. You can specify a built-in preset ("cyber", "sunset", "emerald", "space", "gold", "candy", "noir") or custom colors array and angle.
canvas_set_patternApplies a patterned or textured geometric background to the canvas artboard.
design_audit_layoutAudits the current active canvas for text collisions, layer overlaps, and boundary overflows. Returns actionable recommendations for fixing overlaps and spacing.
element_add_stockAdds a free copyright-free stock image or cutout to the canvas directly by search query, image URL, or asset key.
elements_searchSearches through thousands of copyright-free stock photos, transparent PNG cutouts, SVG vector icons, trust badges, and backgrounds by keywords and category filters.
filter_adjust_valuesManually adjusts color grading sliders on an image layer (brightness, contrast, saturation, hue, blur, noise, sepia, grayscale).
filter_apply_presetApplies an aesthetic color grading preset to an image layer ("Warm Film", "Cyberpunk", "Moody Noir", "Vintage 70s", "Pastel Soft", "Vivid HDR", "Film Grain", "Normal").
history_redoRedoes the previously undone change.
history_undoReverts the canvas to the previous undo history state.
image_addAdds an image layer to the canvas. Source can be ANY local file path on the user computer (e.g. "C:/path/to/img.png" or "workspace-assets/photo.jpg"), an external public URL (e.g. Unsplash), or a Base64 data URL. Set isBackground: true to automatically make it a full-bleed background.
image_cropCrops an image layer with a given aspect ratio (1:1, 4:5, 16:9, 9:16) or custom pixel coordinates.
image_remove_bg_autowrite actionApplies AI 1-click automatic background removal to an image layer by analyzing edges.
image_remove_bg_magicwrite actionPerforms Magic Wand background removal on an image layer by sampling color at click coordinates with tolerance and feather smoothing.
layer_alignAligns an object to the canvas artboard ("center", "left", "right", "top", "bottom", "center_h", "center_v").
layer_deletewrite actionDeletes a layer from the canvas.
layer_duplicateDuplicates an existing layer and adds the copy to the canvas.
layer_reorderReorders a layer in the visual z-index stack ("bring_to_front", "send_to_back", "bring_forward", "send_backward").
layer_set_gradientApplies a gradient fill to an existing text or shape layer by layerId.
layer_set_shadowAdds or updates drop shadow on a layer (color, blur radius, horizontal/vertical offsets, or quick preset: "soft", "float", "glow", "none").
layer_set_stateToggles visibility (hide/show), locks/unlocks selection, or renames a layer.
layer_transformTransforms a layer: move X/Y, rotate angle, flip horizontally/vertically, set opacity, or change blend mode.
layers_get_allReturns the complete hierarchical list of all objects/layers currently on the canvas with their IDs, positions, and styles.
pages_addAdds a new page to the document. Ideal for designing multi-page catalogs, product lookbooks, brochures, magazines, and pitch decks.
pages_deletewrite actionDeletes a page from the document by index (the document must always keep at least 1 page).
pages_duplicateDuplicates an existing page (including all text, shapes, images, and styling) into a new page immediately following it.
pages_listReturns the full list of pages in the current multi-page document with titles, indices, dimensions, and active status.
pages_switchSwitches the active canvas view to a specific page index or page ID so the AI agent can design on that page.
pdf_export_catalogCompiles all pages (or active page) into a print-ready, high-resolution multi-page PDF document and triggers client-side download.
project_export_downloadTriggers the browser to download the current design as PNG, JPEG, SVG, or project JSON.
project_save_localSaves the current design project state to the browser local storage / cloud session.
project_set_titleRenames the active project title displayed in the top navbar and export filename.
shape_addAdds a geometric shape to the canvas (rect, rrect, circle, triangle, star, heart). Supports fills, strokes, corner radius, and opacity.
shape_update_stylewrite actionModifies the fill, stroke, corner radius, or opacity of an existing shape layer.
sticker_addAlias for svg_add. Adds a sticker or badge vector element to the canvas.
studio_batch_actionswrite actionExecutes a sequential batch of multiple canvas actions in one round-trip and returns the final visual screenshot and layer state for rapid design creation.
studio_check_statusChecks whether Tuval Studio is open in the browser and connected to the local WebSocket bridge. If not connected, instructs the AI agent to open https://tuval.site/editor in the user's browser.
studio_export_fileExports the current graphic to a local image file on the host machine (PNG, JPG, WebP, SVG) with customizable resolution scaling (1x, 2x Retina, 3x Print 300DPI, 4x Ultra HD).
studio_get_viewCaptures the current live canvas graphic and layer hierarchy. Returns an image for visual inspection and critique by vision AI models.
svg_addAdds an SVG vector graphic, sticker, or badge to the canvas. Key can be from built-in library ("verified-badge", "sale-badge", "star-burst", "cyber-cross", "arrow-swirl", "sparkle-star", "crown-vip", "fire-flame", "quote-marks", "heart-glow", "abstract-blob") or raw SVG string.
templates_listLists all pre-designed templates across all professional design styles (Bento Grid, Corporate, Branding, Luxury, Minimalist, AI & Tech, Retro 80s, Y2K Rave, Bauhaus, Neobrutalism, Art Deco, Memphis Pop).
text_addAdds a typography text layer to the canvas with styling (fonts: Sora, Inter, Playfair Display, Montserrat, Poppins, Space Grotesk, Roboto, etc.).
text_update_stylewrite actionUpdates typography properties of an existing text layer by its layerId.
Public scan report
scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 8 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumeval / new Function used
exec.evalbundle.mjs: …ode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
How Tuval Studio compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 73% of 1,337 Media servers
- Tools
- 53
- the typical Media server has 7
- Tools that change things
- 17%
- typical: 4%. Fewer write tools means less an agent can break
- Downloads a week
- 107
- more than 63% of 365 Media servers with a package
What its tools let an agent do: 44 read · 9 change
Install Tuval Studio in Claude Code, Cursor or VS Code
Runs npx -y @ariferol01/tuval-studio-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add tuval-studio -- npx -y @ariferol01/tuval-studio-mcp
What the publisher says
From the Tuval Studio repository's README, as published. We do not edit it. Read it on GitHub
Tuval Studio MCP Server 🎨
The Graphic Design MCP, AI Design MCP & PDF Generator MCP for AI Agents
Tuval Studio MCP is the official MCP server for Tuval Studio (tuval.site).
It empowers desktop AI agents — including CodeDL, Claude Desktop, Cursor, Codex, Antigravity, Windsurf, Cline, Roo-Code, and OpenCode — with an autonomous, vision-guided design engine for:
- 🎨 Graphic Design MCP & AI Design MCP: Automated vector composition, typography, mesh gradients, and smart layout audits.
- 📄 PDF Generator MCP & Catalog Generator: Multi-page PDF catalog generation, magazine layouts, brochures, and pitch decks.
- 📊 Presentation Generator & Slide Decks: High-resolution multi-page slide creation with synchronized typography and consistent visual branding.
- 📱 Social Media Design: 1-click marketing banners, Instagram stories, YouTube thumbnails, and ads with zero text overflow.
Looking for a design MCP, PDF MCP, catalog MCP, or graphic design MCP? Tuval Studio MCP connects your AI agent directly to an interactive, client-side browser canvas with 100% privacy and real-time visual feedback!
🌟 Core Features
- 🚀 Zero-Cloud & 100% Private: Operates entirely in your local browser through a high-speed local WebSocket bridge (ws://127.0.0.1:8765). Zero account or server storage required.
- 📚 Multi-Page PDF Catalog Engine: Autonomous creation, management, and export of multi-page magazines, lookbooks, product brochures, and pitch decks with pdfexportcatalog.
- 👁️ Multimodal Vision-in-the-Loop: Every action returns high-res visual snapshots (Base64 PNG) and layer coordinates so AI agents inspect, critique, and perfect their designs visually.
- 🛡️ Zero-Overflow & Boundary Guard: Built-in validation protocol ensuring all typography, buttons, and badges maintain safe margins (min 50px) with no clipping.
- ✨ Full Graphic Suite: Multi-layer vector manipulation, custom Google Fonts (Sora, Inter, Playfair, Cinzel, Syne, etc.), mesh gradients, geometric pattern textures, and 1-click AI background removal.
- 💻 Local File Loading: Load and composite any local photo, asset, or logo from your computer hard drive directly onto the canvas.
⚡ Quick Setup for AI Agents
Add the configuration below to your AI agent's MCP settings file:
1. Claude Desktop (claudedesktopconfig.json)
{
"mcpServers": {
"tuval-studio": {
"command": "npx",
"args": ["-y", "@ariferol01/tuval-studio-mcp@latest"]
}
}
}2. CodeDL, Cursor, Codex, Antigravity, Windsurf, Cline & Roo-Code
{
"mcpServers": {
"tuval-studio": {
"command": "npx",
"args": ["-y", "@ariferol01/tuval-studio-mcp@latest"]
}
}
}How it works: Open Tuval Studio in your browser tab. When your AI agent executes design commands, it connects instantly to your active canvas tab!
🛠️ Complete MCP Tool Catalog
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Tuval Studio: common questions
- Is Tuval Studio MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Tuval Studio safety report
- How do I install Tuval Studio?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Tuval Studio need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Tuval Studio maintained?
- The last commit was 29 days ago (2026-10-05). The latest release is v1.0.7.
- What can I use instead of Tuval Studio?
- Servers from other publishers that do the same job: Dembrandt MCP server, KiCad MCP Pro MCP server and Figma MCP Server.
- How does Tuval Studio compare with other Media MCP servers?
- safety score 85/100 (higher than 73% of 1,337 Media servers); tools 53 (the typical Media server has 7); tools that change things 17% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Tuval Studio
Same job from other publishers: the closest match first, then the best rated.
- DembrandtDesign tokens from any live site: colours, type, spacing, components, drift against a baseline.not reviewedWidely usedB
KiCad MCP ProProduction-grade MCP server for KiCad EDA—PCB design, DRC, simulation, BOM, DFM, and manufacturing.not reviewedEstablishedA- Figma MCP ServerThe Figma MCP server brings Figma design context directly into your AI workflow.not reviewedEstablishedA
- melta UIAI-Ready design system MCP: melta UI tokens, component contracts, 107 rules, check_html self-verifynot reviewedEstablishedA
- Figma UIBidirectional Figma MCP — AI draws UI on Figma canvas, reads designs backnot reviewedEstablishedA