Skip to main content
Glama
storykit-mcp

storykit-mcp

by aryan0078

storykit-mcp

Give an AI structured data and get back a hosted StoryKit widget — or drive the full Studio (images, media, brands, canvases, assets, series, workflows) with a personal API key.

  1. Public widgets (no key) — find_widgets → render_widget → opaque hosted URL.

  2. Studio tools (STORYKIT_API_KEY) — full owner surface under plan limits (~69 remote tools).

Mint a key + paste-ready LLM prompt: asset.storykit.space/ai

CRITICAL: which endpoint?

URL

Auth

Tools

https://asset.storykit.space/api/v1/studio-mcp

Bearer sk_live_…

Full Studio (images included)

https://asset.storykit.space/api/v1/mcp

none

Only widgets (3 tools) — no images

If tools/list lacks generate_image, you are on the wrong server.

Related MCP server: user-majico-mcp

Connect

Remote Studio (HTTP — preferred for images)

export STORYKIT_API_KEY="sk_live_…"
# Claude / Cursor / any streamable-HTTP MCP client:
# URL:  https://asset.storykit.space/api/v1/studio-mcp
# Header: Authorization: Bearer $STORYKIT_API_KEY
claude mcp add --transport http storykit-studio https://asset.storykit.space/api/v1/studio-mcp \
  --header "Authorization: Bearer ${STORYKIT_API_KEY}"

Remote public widgets only

claude mcp add --transport http storykit https://asset.storykit.space/api/v1/mcp

Local stdio (widgets always; Studio when key is set)

export STORYKIT_API_KEY="sk_live_…"   # required for image/studio tools
claude mcp add storykit -- npx -y storykit-mcp@3.3.0

Stdio tool names are prefixed with studio_ (e.g. studio_generate_image → remote generate_image).

HARD RULES for agents

  1. Never invent images with DALL·E, Midjourney, Gemini image, built-in image_gen, Unsplash, etc.

  2. Never invent ids — call list_* / get_* first.

  3. After generate_image / edit_image, poll get_image_job until SUCCEEDED; return platform outputUrl only.

Public tools (no key)

Tool

Spec

find_widgets

{ intent, domain?, dataFields?, kind?, page?, size? } → schemas only

render_widget

{ widgetId, data[], theme?, ttlDays? } → expiring hosted URL (treat as secret)

list_widget_themes

{} palettes

Consent before personal/health data. Max 200 rows. Default TTL 30 days.

Studio tools (STORYKIT_API_KEY)

Call studio_get_account or studio_get_usage first.

Account & image status

Tool

Spec

studio_get_account

{} identity, plan, quotas

studio_get_usage

{} full limits snapshot

studio_get_image_status

{} queue, aspects, remaining

Media library

Tool

Spec

studio_upload_media

{ imageBase64, contentType?, filename? } → mediaId

studio_list_media

{ query?, kind?, trash? }

studio_get_media

{ id }

studio_get_media_content

{ id } base64 ≤2MB

studio_update_media

{ id, title?, tags? }

studio_star_media

{ id, starred }

studio_trash_media / studio_restore_media / studio_delete_media

{ id }

Image AI

Tool

Aliases

Spec

studio_generate_image

studio_image_generate, studio_img_generate

{ prompt, aspect?, qualityMode?, brandKitId?, referenceMediaIds?, count?, magicPrompt?, caption?, mode? }

studio_edit_image

studio_image_edit, studio_img_edit

{ prompt, referenceMediaIds[1..5], maskMediaId?, aspect?, count? }

studio_list_images

{ query?, state? }

studio_get_image_job

{ jobId? } or { id? } — poll until SUCCEEDED

studio_cancel_image_job / retry / delete

{ jobId }

studio_describe_image

{ mediaId? } or { generationId? }

studio_publish_image / unpublish

{ id } numeric generation id

studio_save_image_as_kit

{ jobId }

studio_batch_generate_images

PRO: { prompts[], aspect?, brandKitId?, qualityMode? }

Aspects: square portrait poster story landscape banner
qualityMode: fast | quality

Image workflow

  1. studio_get_account

  2. Optional studio_upload_media → mediaId

  3. studio_generate_image or studio_edit_image

  4. Loop studio_get_image_job until SUCCEEDED

  5. Return platform outputUrl only

Prompt / vision

Tool

Spec

studio_compile_prompt

{ draft } → caption for generate_image.caption

studio_analyze_image_to_prompt

{ imageBase64, contentType?, aspect?, layout? }

studio_get_vision_job

{ jobId, apply? }

Brands

Tool

Spec

studio_list_brand_kits

{ query?, page?, size? }

studio_get_brand_kit

{ id }

studio_extract_brand_kit

{ imagesBase64:[{base64,contentType?}], prompt?, md? }

studio_refine_brand_kit

{ id, feedback }

studio_rename_brand_kit

{ id, name }

studio_duplicate_brand_kit

{ id, name? }

studio_delete_brand_kit

{ id }

studio_publish_brand_kit / unpublish

{ id }

studio_brand_showcase

{ id, count? }

Canvases

Tool

Spec

studio_list_canvases

{}

studio_get_canvas

{ id } includes doc

studio_create_canvas

{ title?, aspect? }

studio_save_canvas

{ id, title?, aspect?, doc?, thumbnailMediaId? }

studio_duplicate_canvas / studio_delete_canvas

{ id }

Studio assets (commissioned widgets)

Tool

Spec

studio_list_studio_assets

{}

studio_get_studio_asset

{ id } no source code

studio_commission_studio_asset

{ prompt, kind?, purpose?, sourceMd? }

studio_iterate_studio_asset

{ id, feedback }

studio_rename_studio_asset

{ id, title }

studio_trash_studio_asset / restore

{ id }

studio_list_folders / studio_create_folder

create: { name }

Series & workflows

Tool

Spec

studio_list_series / get / create / series_next / series_extend / delete

see input schemas

studio_list_workflows / get / create / update / run / delete / list_workflow_runs

Remote names drop the studio_ prefix. Full list: tools/list on studio-mcp.

Track usage at storykit.space/me.

Environment

Variable

Purpose

STORYKIT_API_BASE

API host (default https://asset.storykit.space)

STORYKIT_API_KEY

Personal sk_live_… for Studio tools

STORYKIT_STUDIO_MCP

Override Studio MCP URL

MIT. Created with love by Story Kit.

Available Tools

7 tools
bundle_urlA

Build a download URL for a .zip bundle of one or more assets (each as standalone index.html + asset.json, plus a composed page.html). Optionally pass theme id to skin the composed page.

Inputs: ids (required), theme.

get_assetA

Get the full JSON for one asset by id: descriptor, dataSchema (row shape for data-sk-items), html/css/js when self-contained, plus embed.snippet, links.embedHtml, and links.bundle.

Inputs: id (required).

get_embed_snippetA

Get the copy-paste embed snippet for an asset — a with example data-sk-items + the hosted sk-embed.js runtime. Replace data-sk-items with your rows (see dataSchema from get_asset).

Inputs: id (required).

list_chart_familiesA

List Datawrapper-aligned chart families (65+) mapped to StoryKit blockTypes — each family has whenToUse, a sample variant, and sampleData. Search kind=CHART_VARIANT to find published skins for a family.

Inputs: no named parameters.

list_theme_familiesA

List editorial theme palette families — seeded as published THEME assets for reuse in embeds and bundles.

Inputs: no named parameters.

list_themesA

List published StoryKit themes (palette + vibe) for composing a page or bundle export.

Inputs: no named parameters.

search_assetsA

Search the StoryKit design library. Returns matching blocks (id, name, kind, blockType, embed snippet, dataSchema when the asset accepts rows). Kinds: CHART_VARIANT, ANIMATION, TEXT_STYLE, THEME, COMPONENT, SVG, INTERACTIVE. INTERACTIVE covers the animated/self-contained widgets: draggable knobs + gauges + faders, skeuomorphic controls, blueprint cutaways, maps, quizzes. Sort: newest (default), used, name. Paginate with page + size (max 50).

Inputs: kind, page, size, sort, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct function: bundle URL generation, asset retrieval, embedding, and various listing/search operations. No overlapping purposes.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with lowercase underscores (bundle_url, get_asset, list_chart_families, etc.), making naming predictable.

    Tool Count5/5

    7 tools cover key operations without redundancy, suitable for a design library and bundle generation service.

    Completeness4/5

    Covers retrieval, search, and bundle creation for assets, but lacks tools for creating, updating, or managing assets, which may be intentional but leaves some gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for Majico.xyz that enables coding agents to read (and limited write) brand guidelines, design tokens, studio canvas, and export manifests.
      9 npm
      MIT
    • F
      license
      Not graded
      quality
      F
      maintenance
      Enables searching, retrieving, and downloading Streamline's icons, illustrations, elements, and emojis in PNG or SVG formats with customization options, via MCP-compatible clients.
      -
    • A
      license
      A
      quality
      D
      maintenance
      All-in-one asset search MCP server for AI coding agents, enabling search for icons, logos, stock photos, vectors, and emoji from a single tool call.
      4
      8
      5
      MIT