io.github.cueqzapper/picorn

Tools

• picorn_account_status

  Show which Picorn account the MCP is connected to and its connected social media accounts. Requires a personal Picorn access token; without one it explains how to connect.

  shallow
• picorn_blueprint_compile

  Compile a PBL document you wrote (pbl) or apply #id patch lines to an earlier compile (blueprintId + patch). No model is called: Picorn searches the curated asset libraries, measures text with the real fonts, lays out, reviews and renders. Returns blueprintId, errors/warnings with codes and fixes, the scene report + ASCII wireframe (exact boxes, colours, effects, search hits), the canonical source and an inline preview of every slide. Patches reuse the cached asset searches, so iterate with small patches until errors=0 and the preview is visually finished. Set preview:false for an even faster text-only check. A line `search q2 generate photo "…"` (or `generate text` for lettering-heavy mockups) creates a NEW picture as ref when the library has nothing fitting; Library first: browse with picorn_search_library (or use search lines in picorn_blueprint_compile), and generate only when the design would benefit massively from a new picture (no fitting hero photo exists). Generation needs a connected Picorn account with credits; it is charged at 1.2 × the fal price (a Krea 2 Turbo picture of about 1 MP costs about 1 ct). Generated pictures are cached in the blueprint, so patches never pay twice.

  shallow
• picorn_blueprint_create_file

  Turn a compiled blueprintId into a persistent, fully editable Picorn editor file (native text, shape and image layers through the editor importer), render every slide and return the editorUrl, render URLs and a contact sheet. With a Picorn access token the file lands in your account and can be linked to a campaign idea (campaignId + ideaId) and scheduled with picorn_posts_schedule.

  shallow
• picorn_blueprint_examples

  Return reviewed PBL showcase posts (photo-led post, tips carousel with master, type-led story, typographic event) that compile with 0 errors. Use them to learn proven structure, spacing and effect choices; write new copy, colours and fonts from the brief instead of reusing theirs.

  shallow
• picorn_blueprint_spec

  Return the complete Picorn Blueprint Language (PBL) spec: syntax, design rules, a full example and the repair patch rules. Read it once before writing PBL. PBL is a compact line language: regions + stacks, library asset search, components, every editor effect. The engine measures text with real fonts and does all geometry.

  shallow
• picorn_campaigns_create

  Create a campaign in the user's Picorn account from agent-authored post ideas (no model is called). The campaign lives in a marketing project: pass workspaceProjectId + workspaceProjectKey from picorn_projects_create, or omit both to create a new project named after the topic. Returns campaignId and one ideaId per idea. Create each post file with the same workspace plus campaignId + ideaId, then schedule it with picorn_posts_schedule. Requires a Picorn access token.

  shallow
• picorn_campaigns_inspect

  Read one campaign with its ideas and linked file IDs. Requires a Picorn access token.

  shallow
• picorn_campaigns_list

  List the user's campaigns with their ideas and the files linked to each idea. Requires a Picorn access token.

  shallow
• picorn_capabilities

  List live canvas formats, fonts, layouts, image models, GPU reachability and fair-use limits.

  shallow
• picorn_design_image

  Turn a topic into a finished social image with generated/researched imagery and crisp real typography. Best default for ready-to-share work. Returns an inline preview and public creationUrl.

  shallow
• picorn_edit_image

  Transform an existing image with Flux 2 Klein. Returns an inline preview and public creationUrl.

  shallow
• picorn_editor_add_layer

  Add a native editor layer. Supported types: text, image, shape, group, qr, video, audio. SVG uses an image layer with isSvg:true. Position is the layer CENTER in canvas pixels. The layer accepts the same persisted fields as /editor: transforms, opacity, blendMode, text styles/effects/rich text, image filters/customFilters/crop/masks/local effects/perspective, shape gradients/strokes/shadows, QR styling, timeline ranges, trims, volume, and keyframes. Returns the changed slide as an inline preview automatically.

  shallow
• picorn_editor_add_slide

  Add another slide to an editor project. Projects support up to 20 slides. Returns the new slide as an inline preview.

  shallow
• picorn_editor_align_layers

  Align positioned layers to their shared left, center, right, top, middle, or bottom bound.

  shallow
• picorn_editor_create_project

  Create a persistent native Picorn editor project with one empty slide. This is the starting point for multi-layer and multi-slide work. Returns projectId, slideId, exact canvas dimensions, and the canonical /studio/editor?runId=... editorUrl that must be included in the final answer.

  shallow
• picorn_editor_create_slideshow

  Create, persist and render a complete 1–20 slide Picorn file in one deterministic call from finished agent-authored SVG and/or native editable layers. The calling agent is the only design model: this path does not call /api/generate-svg, Gemini, OpenRouter, or another LLM. Work is bounded before persistence to 50,000,000 total canvas pixels and 1,000 total layers. Fair-use cost is one unit per four slides, rounded up. Returns every persistent render URL, an inline contact-sheet preview, and the canonical editorUrl. Response provenance is modelProvider="calling-agent" and externalLlmCalls=0.

  shallow
• picorn_editor_delete_layers

  Delete one or more layers and clean their group references.

  shallow
• picorn_editor_delete_slide

  Delete a slide and its layers. A project always keeps at least one slide.

  shallow
• picorn_editor_distribute_layers

  Evenly distribute three or more positioned layers horizontally or vertically.

  shallow
• picorn_editor_duplicate_layer

  Duplicate a non-group layer, including all style, filter, effect, mask, and animation properties.

  shallow
• picorn_editor_group_layers

  Create the same metadata group used by the visual editor. Grouping preserves world positions and render output.

  shallow
• picorn_editor_import_image

  Import image bytes from any external or agent-native image generator into Picorn storage. Pass imageBase64 with or without a data: prefix, then use the returned imageUrl in one or more native image layers. This is the bridge for iterative generator → editor → render workflows.

  shallow
• picorn_editor_inspect_project

  Read the complete project, including every slide, layer, property, z-index, and latest rendered image URL.

  shallow
• picorn_editor_render_project

  Render selected or all slides through Picorn's real Fabric editor pipeline. Returns persistent public image URLs, creationUrl, and the canonical editorUrl that must be given to the user. Static renders include text, image/SVG, shape, group and QR layers; video/audio timing remains editable project data for the video editor.

  shallow
• picorn_editor_reorder_layers

  Set layer order. objectIds are bottom-to-top; omitted existing IDs retain their relative order on top.

  shallow
• picorn_editor_ungroup_layers

  Remove a group while preserving all child layers.

  shallow
• picorn_editor_update_layer

  Patch any editable property on a layer: content, position, size, transform, style, filters, masks, effects, blend mode, visibility, lock state, SVG overrides, timing, audio, or keyframes. Returns the changed slide as an inline preview automatically.

  shallow
• picorn_editor_update_slide

  Change a slide background, semantic role, or image prompt. Returns the changed slide as an inline preview.

  shallow
• picorn_files_list

  List the user's own Picorn files (posts and slideshows, newest first) with fileId, title, project, aspect ratio, thumbnail and editorUrl. No workspace key is needed. Any fileId can be scheduled with picorn_posts_schedule; files made in the web editor post the slides Picorn last rendered for them. Files with mcpEditable: true can also be changed with the picorn_editor_* tools. Page with nextCursor. Requires a Picorn access token.

  shallow
• picorn_generate_image

  Generate a raw image with self-hosted Z-Image Turbo. Returns an inline preview and public creationUrl.

  shallow
• picorn_generate_vector_assets

  Use Picorn's native editor engine: first generate raster artwork with self-hosted Z-Image Turbo on ComfyUI, remove its background, then convert it through the bundled multi-colour SVG converter. Generates five variants, selects the strongest result and returns the top three. Signets also return one layered editor file that displays the three shortlisted SVGs inside the same native project. Use this tool for every newly generated signet and custom icon.

  shallow
• picorn_media_list

  List the photos the user already uploaded to Picorn (newest first), so a post can be built from them without uploading again. Returns mediaId, imageUrl, thumbnailUrl and pixel size per photo. Pass a mediaId to picorn_editor_import_image, or use the imageUrl directly in an image layer. includeGenerated: true also lists images Picorn generated for the user. Page with nextCursor. Requires a Picorn access token.

  shallow
• picorn_posts_cancel

  Cancel the scheduled post of a file before it is published; it is removed from the social media scheduler. Requires a Picorn access token.

  shallow
• picorn_posts_list

  List the user's scheduled and published posts in a time window (ISO dates). Requires a Picorn access token.

  shallow
• picorn_posts_schedule

  Schedule a finished static Picorn file (one image, or several slides as one carousel) on the user's connected social accounts for the given platforms. The file is re-rendered first so the post shows its current state. scheduledAt is ISO-8601 with timezone (e.g. 2026-11-02T09:00:00+01:00); publishNow: true posts immediately. Calling it again for the same file reschedules the existing post. Each post costs $0.02 from the Picorn balance. With several accounts on one platform pass accountIds (from picorn_account_status); otherwise the first connected account per platform posts. The file must belong to the user: created while connected with the token, or listed by picorn_files_list. Requires a Picorn access token.

  shallow
• picorn_projects_create

  Create a marketing project that can hold many editor files and imported image assets. Keep the returned workspaceProjectId and workspaceProjectKey together; use them when adding every related file.

  shallow
• picorn_projects_inspect

  List every editor file, imported asset, and the project brand profile with named colors and saved logos or visual references. File entries include their current thumbnail, status, creation URL and canonical /studio/editor?runId=... editorUrl. Always give the user that editorUrl.

  shallow
• picorn_projects_update

  Update the name, description, or named color scheme of a marketing project, then return its complete file, asset, and brand index.

  shallow
• picorn_render_svg

  Render your SVG through Picorn with real typography and optional image/icon placeholders. Returns an inline preview and public creationUrl.

  shallow
• picorn_search_areas

  Find approved torn, wavy, blob, banner and other decorative shapes for a design.

  shallow
• picorn_search_icons

  Search Picorn's vector icon library before composing a design.

  shallow
• picorn_search_library

  LIBRARY FIRST. Browse Picorn's own libraries (photos, wallpapers, vector illustrations, ~300k icons, stickers, textures, shapes, badges) and SEE the hits as one numbered contact sheet. Free, also without an account. This is the same search the Blueprint engine runs: once a hit fits, write `search q1 <kind> "<words>"` with the same kind and words in picorn_blueprint_compile and the compile gets these pictures in this order (wallpaper → background, vector → illustration). Words may be German or English; short concrete English nouns match best. Generating a picture costs credits and is the exception: only when nothing here fits and the design would benefit massively.

  shallow
• picorn_social_accounts_connect

  Create an OAuth link that connects a social media account to the user's Picorn account. Give the authUrl to the user to open in a browser, then check picorn_account_status. Requires a Picorn access token.

  shallow
• picorn_video_add_clip

  Add a video or audio clip to a Picorn timeline. Source URLs must use an approved public media host. Video positions are center coordinates; timing and trim values are frame-based.

  shallow
• picorn_video_create_project

  Create a persistent video project with a real 30fps timeline, native layers, keyframes and a canonical /video/editor link.

  shallow
• picorn_video_import_media

  Upload agent-owned MP4, WebM, MOV, MP3, WAV, AAC, M4A or OGG bytes into Picorn storage for use by video/audio timeline layers. Maximum 15 MB.

  shallow
• picorn_video_render_project

  Render the native timeline to a finished MP4/H.264 or WebM/VP9 file. The render includes multi-slide sequencing, timed layers, video frames, keyframe animation and mixed audio, and returns a public video URL plus /video/editor link.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/bec03da4-2ce6-457f-ba9e-e27aef8c61e3/badge.svg)](https://vouch.tools/servers/bec03da4-2ce6-457f-ba9e-e27aef8c61e3)