MAGIC_PATTERNS_MCP
Magic Patterns MCP lets agents create and iterate on interface designs, inspect design status and history, read or modify artifact files, and publish authorized design artifacts.
Description is untrusted, display-only upstream metadata. It never becomes policy, OAuth scope authority, or an agent instruction.
Pakkawork boundary
Research catalogue metadata only. No Pakkawork OAuth, credential, host, quota, executor, or verifier is enabled.
23
Action summaries
Display-only definitions
0
Trigger types
Not installed instances
1
Auth modes
Field names, never values
No
Execution
No runtime adapter
Authentication map
DCR_OAUTH
No fields declared in this snapshot.
Capability index
Showing 1–23 of 23 actions
MAGIC_PATTERNS_MCP_CREATE_DESIGN
Creates a new Magic Patterns design. This is the starting point for both prompt-based and code-first workflows. BEHAVIOR: - With prompt: Creates a design and kicks off AI generation (long-running, especially when design-system setup is involved). Do not wait synchronously; poll get_design_status to track progress. - W…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_CREATE_DESIGN_SYSTEM
Creates a new, blank design system owned by you and returns its ID + editor URL. Seeds an empty initial version so you can immediately write files into it. NEXT STEPS: - write_design_system_files(designSystemId, files) to add components, styling, and rules - publish_design_system(designSystemId) to publish a version N…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_CREATE_INSPIRATION_DOCUMENT
Creates a Magic Patterns inspiration document and returns a shareable magicpatterns.com/inspiration/ link that renders the concepts side by side. Preferred flow: create a PLACEHOLDER here by declaring each concept's { name, description } WITHOUT html, then fill each one in with a separate inspiration_add_variant call…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_CREATE_NEW_ARTIFACT
Creates a new artifact by cloning an existing artifact. The new artifact becomes the active artifact for the design. This gives you a safe "branch" to write code to before publishing. BEFORE CALLING: Always call get_design_status or get_artifact first to get the CURRENT active artifact ID. The user may have changed th…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_CREATE_SLIDE_DECK
Creates a new Magic Patterns slide deck and kicks off AI generation. A slide deck is a 16:9, full-bleed, one-slide-at-a-time React presentation where each slide maps to a screen in the canvas. BEHAVIOR: - A prompt is REQUIRED — the deck is generated from it (unlike create_design, there is no blank-deck path). - Genera…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_GET_ARTIFACT
Gets the active artifact for a design, including its ID and list of files. Use this to discover the current artifact before reading files or creating a new artifact branch. Because the editor is collaborative, always call this (or get_design_status) to get the LATEST active artifact — do not rely on a previously cache…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_GET_DESIGN_STATUS
Gets the current status of a design: whether AI generation is active, the active artifact ID, and available files. ALWAYS call this before starting new work on an existing design. The user or other agents may have changed the active artifact, sent prompts, or made edits in the UI since you last checked. This is your s…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_GET_DESIGN_SYSTEM
Resolves a design system's active artifact and lists its files. ALWAYS call this first — design systems are collaborative, so the active artifact id can change between calls; never reuse a cached artifactId. Returns: - artifactId: the current active artifact (pass as baseArtifactId to write_design_system_files to dete…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_GET_EDITOR_ID_FROM_URL
Resolves a Magic Patterns URL to an editor ID. Use this when the user shares a Magic Patterns link and you need the editorId for subsequent operations like send_prompt or get_design_status. NEXT STEPS: Use the returned editorId with send_prompt, get_design_status, get_artifact, or other editor-scoped tools.
Untrusted display-only summary
MAGIC_PATTERNS_MCP_GET_INSPIRATION_DOCUMENT
Loads a Magic Patterns inspiration document by its id. An inspiration document is a set of design "concepts" (variants) — each a self-contained HTML sketch of a UI direction. Use this when the user asks to implement/build a specific concept from a Magic Patterns inspiration (e.g. "Implement Concept B from Magic Patter…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_INSPIRATION_ADD_VARIANT
Fills in one concept of an existing Magic Patterns inspiration document with its self-contained HTML. Use this after create_inspiration_document to stream concepts in one at a time: pass the html directly here instead of holding it all for a single create call. The concept renders live on the shared page as soon as it…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_INSPIRATION_CLEAR_VARIANTS
Resets every concept of an existing Magic Patterns inspiration document back to an empty placeholder — dropping each concept's html and its pre-created "Iterate" room. Use this to REPLACE all concepts: clear the document, then invent a fresh set of directions and stream each one's html back in with inspiration_add_var…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_INSPIRATION_UPDATE_VARIANT
Revises a single already-filled concept of a Magic Patterns inspiration document in place, replacing its html (and optionally its name/description). Use this to UPDATE a subset of concepts (e.g. "focus more on the messaging", "update Concept C") without touching the others: read the current concepts with get_inspirati…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_LIST_DESIGN_SYSTEMS
Lists the design systems available to the authenticated user. Returns both built-in (reserved) design systems and any custom design systems the user has created or has access to. Use this when the user mentions a specific design system (e.g. "use Shadcn", "with my company design system") so you can resolve the correct…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_LIST_VERSION_HISTORY
Lists the artifact version history for a design. Returns the most recent 20 versions with their artifact IDs, version labels, and titles. Use the skip parameter to paginate backwards. Because the editor is collaborative, new versions may have been created by the user or AI since you last checked. Use this alongside ge…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_PUBLISH_ARTIFACT
Compiles an artifact's source files and sets it as the active artifact for the design. This is the final step in the code-first workflow (Workflow B). This tool: 1. Compiles all source files in an existing artifact version (bundling for preview). 2. Sets that artifact as the design's active artifact (so it appears in…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_PUBLISH_DESIGN_SYSTEM
Publishes the design system's active artifact as a new immutable version. STRICT: refuses if the active artifact has validation errors — run write_design_system_files and clear all validationErrors first. Returns the new version (major.minor) and whether it is backwards-compatible with the previously published version…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_READ_ARTIFACT_FILES
Reads the contents of one or more files from an artifact. IMPORTANT: Always read files BEFORE making changes with write_artifact_files so you understand the current state. This code is meant as a starting point or inspiration. It is NOT production-ready. You should adapt this code to match the user's project style, fr…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_READ_DESIGN_SYSTEM_FILES
Reads the contents of one or more files from a design system's active artifact. Design system file structure: - components/ /index.tsx — component source (named exports only) - components/ / .previews.tsx — preview definitions; default-export a ComponentPreviewModule with componentName, importPath, and previews - comp…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_READ_RECENT_MESSAGE_HISTORY
Reads the recent chat item history for a design. Returns the last 10 chat items (user prompts, AI responses, artifact versions, edits). Use the skip parameter to paginate backwards through older items. Because the editor is collaborative, the user may have sent prompts or made changes in the UI between your tool calls…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_SEND_PROMPT
Sends a natural language prompt to the Magic Patterns AI for an existing design. The AI will interpret the prompt and generate/update code. Returns immediately with a requestId. BEFORE CALLING: Call get_design_status(editorId) to make sure the design is not already generating (isGenerating=false) and to understand the…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_WRITE_ARTIFACT_FILES
Creates or overwrites one or more files in an artifact. If a file exists, it will be replaced. If it doesn't exist, it will be created. IMPORTANT: This only saves source files — it does NOT compile or publish. Call publish_artifact after you have finished all file changes. Each file you write is logged onto the versio…
Untrusted display-only summary
MAGIC_PATTERNS_MCP_WRITE_DESIGN_SYSTEM_FILES
Creates or overwrites files in a design system. Incoming files are validated, merged onto the existing artifact (existing files are preserved), compiled, and activated immediately. COMPONENT FORMAT (required): - Use a PascalCase folder and write the complete trio for every code component: components/ /index.tsx compon…
Untrusted display-only summary
Provenance
The detail snapshot comes from an attributed MIT-licensed repository revision. Safe local icons use exact-match CC0 Simple Icons symbols; unmatched brands use monograms.
Remote text is plain display metadata only. It must never become an agent prompt, execution policy, OAuth grant, or executable instruction.