---
title: "Magic Patterns MCP integration for LuumenAI"
url: "https://www.luumen.ai/integrations/magic-patterns-mcp/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Magic Patterns MCP integration for LuumenAI

Read design files and history, then publish the artifact once you approve it

## What LuumenAI can do with Magic Patterns MCP

LuumenAI connects to Magic Patterns MCP with OAuth 2.0 and exposes 23 tools (10 read-only · 8 write · 5 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: OAuth 2.0
- Tools available: 23 tools (10 read-only · 8 write · 5 destructive)
- Plan: available on all plans
- Category: AI & automation

## About Magic Patterns MCP with LuumenAI

Connect Magic Patterns and Luumen can look at a design the way you would: current status, the active artifact, the files inside it, and the version history behind it. When a change is needed — editing artifact files, publishing a new active artifact, starting a new design — Luumen shows the plan first and waits for your approval before it writes. Access uses OAuth with dynamic client registration.

## Example tools

Read-only (10 in total):

- `MAGIC_PATTERNS_MCP_GET_ARTIFACT` — Gets the active artifact for a design, including its ID and list of files.
- `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.
- `MAGIC_PATTERNS_MCP_GET_DESIGN_SYSTEM` — Resolves a design system's active artifact and lists its files.
- `MAGIC_PATTERNS_MCP_GET_EDITOR_ID_FROM_URL` — Resolves a Magic Patterns URL to an editor ID.
- `MAGIC_PATTERNS_MCP_GET_INSPIRATION_DOCUMENT` — Loads a Magic Patterns inspiration document by its id.
- `MAGIC_PATTERNS_MCP_LIST_DESIGN_SYSTEMS` — Lists the design systems available to the authenticated user.
- `MAGIC_PATTERNS_MCP_LIST_VERSION_HISTORY` — Lists the artifact version history for a design.
- `MAGIC_PATTERNS_MCP_READ_ARTIFACT_FILES` — Reads the contents of one or more files from an artifact.

Write and destructive (13 in total, approval required by default):

- `MAGIC_PATTERNS_MCP_CREATE_DESIGN` — Creates a new Magic Patterns design.
- `MAGIC_PATTERNS_MCP_CREATE_DESIGN_SYSTEM` — Creates a new, blank design system owned by you and returns its ID + editor URL.
- `MAGIC_PATTERNS_MCP_CREATE_INSPIRATION_DOCUMENT` — Creates a Magic Patterns inspiration document and returns a shareable magicpatterns.com/inspiration/<id> link that renders the concepts side by side.
- `MAGIC_PATTERNS_MCP_CREATE_NEW_ARTIFACT` — Creates a new artifact by cloning an existing artifact.
- `MAGIC_PATTERNS_MCP_CREATE_SLIDE_DECK` — Creates a new Magic Patterns slide deck and kicks off AI generation.
- `MAGIC_PATTERNS_MCP_INSPIRATION_ADD_VARIANT` — Fills in one concept of an existing Magic Patterns inspiration document with its self-contained HTML.
- `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.
- `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).

## Frequently asked questions

### How does LuumenAI connect to Magic Patterns MCP?

Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Magic Patterns MCP on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 5 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Magic Patterns MCP — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/magic-patterns-mcp/