
Adobe Design Data Agent MCP, Adobe's token authoring server
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install design-data-agent MCP
Claude Code
- 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
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 ·
primerFinds tokens with a filter expression
Returns the design tokens that match a filter expression.
Try: “Find all tokens for the button component.”
Read ·
query_tokensGives 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_tokenSuggests 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_tokenShows 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_componentReads one design guideline
Returns the full content and metadata of a guideline by its ID.
Try: “Show the motion guideline.”
Read ·
describe_guidelineLists the design guidelines
Lists guideline IDs and metadata, optionally by category.
Try: “List the guidelines about color.”
Read ·
list_guidelinesChecks 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_usageCompares 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_datasetsSaves 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 ·
writeStarts 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_sessionDescribes 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_intentSets the token's layer, property and name
Sets the layer, property and name fields for the new token and checks them against the field catalog.
Try: “Classify it as a component token for background-color.”
Write ·
authoring_session_step_classificationSets the token's values
Sets value rows that each hold a literal value or an alias, for the modes that matter.
Try: “Set the light value to #fff and dark to #000.”
Write ·
authoring_session_step_valuesWrites the new token to a file
Builds the token, writes it into a tokens file and ends the session.
Try: “Commit the token to the color tokens file.”
Write ·
authoring_session_commitCancels a token authoring session
Cancels a session and deletes its saved file.
Try: “Cancel the current authoring session.”
Delete ·
authoring_session_cancelShows a session's current state
Returns the current state of an authoring session.
Try: “Where am I in the current authoring session?”
Read ·
authoring_session_getLists open authoring sessions
Lists every active authoring session.
Try: “List my open authoring sessions.”
Read ·
authoring_session_listChanges fields on an existing token
Merges updates into a committed token and checks it again. The token's ID is kept.
Try: “Change the description of the focus ring token.”
Write ·
edit_tokenMarks a token as deprecated
Adds a deprecation marker, and can record a replacement and a planned removal version.
Try: “Deprecate the old accent token and point to the new one.”
Write ·
deprecate_tokenGives a token a new name
Assigns a new name to a token and keeps its ID, with an optional pointer to the replacement.
Try: “Rename the border token to border-subtle.”
Write ·
rename_tokenPoints an alias token at another token
Changes which token an alias refers to. The new target must exist.
Try: “Make the link color alias point to the new accent token.”
Write ·
rewire_aliasDeletes a token from a file
Deletes a token, but stops if any other token still refers to it.
Try: “Remove the unused legacy-gray token.”
Delete ·
remove_tokenAdds a mode to a mode set
Appends a new mode to an existing mode-set file.
Try: “Add a high-contrast mode to the color scheme set.”
Write ·
add_modeRenames a mode everywhere it is used
Renames a mode in its mode-set file and updates every token file that uses it.
Try: “Rename the dark mode to night.”
Write ·
rename_modeDeletes a mode from a mode set
Removes a mode, but stops if any token uses it or if it is the default.
Try: “Remove the unused sepia mode.”
Delete ·
remove_modeCreates a new mode set
Writes a new mode-set file for a new dimension, such as a density option.
Try: “Create a density mode set with compact and comfortable.”
Write ·
create_mode_setDeletes a mode set
Deletes a mode-set file, but stops if any token still uses that dimension.
Try: “Remove the old platform mode set.”
Delete ·
remove_mode_setCreates a component, field, guideline or similar file
Creates a new non-token data object after checking it against its schema. Fails if the file exists.
Try: “Create a new guideline page for data tables.”
Write ·
data_createReplaces an existing data file
Replaces a non-token data object with a new document after checking it against its schema. It is a full replace, not a patch.
Try: “Update the typography guideline with this text.”
Write ·
data_edit
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-only | No read-only switch is documented. Adobe's design-data server gives lookups only, with no editing tools. |
|---|---|
| Talks to | npm 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
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 4Hide
- design-data-agent-mcp README · github.com
- design-data-agent-mcp tool source · github.com
- github.com · github.com
- github.com · github.com