PlugWiki
design-data-agent-mcp logo

Adobe Design Data Agent MCP, Adobe's token authoring server

Official · by AdobeLocal

Lets your AI assistant read, validate and edit Adobe Spectrum design data: tokens, modes, components and guidelines.

This is Adobe's server for teams that maintain Spectrum design data, not just read it. It lets Claude or Cursor look up tokens and guidelines, check token usage, compare datasets, and add, rename, deprecate or remove tokens in your files. It runs on your machine with Spectrum data built in. The 9 lookup, check and compare tools run inside the server. The other 21 tools, which write or delete, call Adobe's design-data command-line program, so install it first (the install box does not include it).

Good for

  • Design system maintainers who add and retire tokens in a dataset
  • Token authors who want a guided, checked way to create tokens
  • Reviewers who compare two versions of a token set

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install design-data-agent MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the design-data-agent MCP server to Claude Code. Run this command:
    
    claude mcp add design-data-agent -- npx -y @adobe/design-data-agent-mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Built from the package data we hold. Not yet tested by us.

Tools

  • Loads the full token and component overview

    Returns the token taxonomy, resolved values, component list and field definitions. The server says to call it at the start of a session.

    Try: “Load the design data primer.”

    Read · primer

  • Finds tokens with a filter expression

    Returns the design tokens that match a filter expression.

    Try: “Find all tokens for the button component.”

    Read · query_tokens

  • Gives a token's final value in context

    Resolves a token property to its final value for a component, variant, state or theme setting, and flags ambiguous or deprecated results.

    Try: “What is the background color of the primary button in dark mode?”

    Read · resolve_token

  • Suggests tokens from a plain description

    Returns tokens matching a description in plain words, ranked by confidence.

    Try: “Which token fits a subtle divider line?”

    Read · suggest_token

  • Shows a component's schema and token bindings

    Returns the JSON schema and token relationships for a component by its ID.

    Try: “Describe the checkbox component and its tokens.”

    Read · describe_component

  • Reads one design guideline

    Returns the full content and metadata of a guideline by its ID.

    Try: “Show the motion guideline.”

    Read · describe_guideline

  • Lists the design guidelines

    Lists guideline IDs and metadata, optionally by category.

    Try: “List the guidelines about color.”

    Read · list_guidelines

  • Checks token usage in a dataset

    Runs structural and relational checks on a dataset and returns a report of violations and warnings.

    Try: “Validate the tokens in my dataset and list the errors.”

    Files · validate_usage

  • Compares two datasets

    Returns the tokens that were added, removed or changed between two datasets.

    Try: “Compare my old and new token folders and list what changed.”

    Files · diff_datasets

  • Saves design context into the dataset

    Writes agent-generated design context, such as a product context file, into the dataset.

    Try: “Save a summary of our brand rules into the dataset.”

    Write · write

  • Starts a guided session to add a new token

    Opens a token authoring session that you step through, and returns a session ID.

    Try: “Start adding a new border color token.”

    Write · start_authoring_session

  • Describes the token you want and gets matches

    Records what the token is for and returns existing tokens that could be reused.

    Try: “The token is for the focus ring color. Is there one already?”

    Write · authoring_session_step_intent

Read from the source code

Permissions

high risk · 3 things to watch

High risk

The assistant can create, change and delete token, mode and guideline files in the dataset folder you point it at. Keep that folder in git and review the diff after each session.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It edits and deletes files on disk

    Tools can remove tokens, modes and mode sets and replace whole data files. Commit before you start so you can review and undo. github.com

  • Removals have built-in guards

    Removing a token, mode or mode set stops if something else still refers to it. Check what depends on an item before you ask for a rename. github.com

  • Point it at the right folder

    Path settings decide which dataset it edits. Set them to a project checkout, not a folder you cannot restore. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only switch is documented. Adobe's design-data server gives lookups only, with no editing tools.
Talks tonpm registry (optional check for a newer Spectrum data version, can be turned off)

Questions

Can it edit my files?

Yes. It can write new tokens, edit and rename them, and delete tokens, modes and mode sets in the dataset folder you configure. Use git to review changes.

How is it different from design-data-mcp?

design-data-mcp is read-only and has 7 lookup tools. This one adds checking, diffing and many editing tools, and can also work on your own dataset.

Do I need the design-data command-line program?

Yes, for editing. The 9 read, validate and diff tools run inside the server. The 21 tools that write or delete (authoring sessions, edit, rename, remove, mode and data tools, and write) call the design-data program, and so does a platform config file. Adobe's README installs it with Homebrew: brew tap adobe/spectrum-design-data https://github.com/adobe/spectrum-design-data, then brew install adobe/spectrum-design-data/design-data. Set DESIGN_DATA_BIN if it is not on your PATH. The README says only one authoring step needs it, but the source shows the others call it too.

Does it need an API key?

No. It runs locally with Spectrum data built in and needs no account.

Is there a Claude Code skill?

Yes. The README describes a Claude Code skill and plugin marketplace entry that ship with this package. They are separate from the server.

How do I add it to Cursor?

Use the Cursor tab in the install box above. Set the path settings if you want it to work on your own dataset.

Information

updated Nov 2, 2026

Publisher
Adobe (official)
Package
@adobe/design-data-agent-mcp
Registry
npm
Transport
stdio
Auth
None
Version
1.15.3
License
Apache-2.0
Last commit
Oct 31, 2026
Open issues
27

GitHubnpm

Other Adobe MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. design-data-agent-mcp README · github.com
  2. design-data-agent-mcp tool source · github.com
  3. github.com · github.com
  4. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.