Skip to content
Agentic Experience Design Language Help Go to the portal

What is the MCP server?

How AI tools look up the design language, and when to run the server on your computer or use the portal's.

For developers2 min read

The MCP server is how AI tools look things up in the Agentic Experience Design Language. Through MCP (Model Context Protocol), an open standard most AI tools support, an agent asks for exact component props, tokens, icons, templates and rules instead of guessing, and checks what it wrote.

Design Language Connect and the plugins set it up for you. Read on when you add it to a tool by hand, or want to know which server a tool is using.

Two ways to run it

Two ways to run it
On your computerOn the portal
Howpfdl mcp, over stdiohttps://<your portal>/mcp, over HTTP
NeedsNode.js 20 and the pfdl command lineThe address, and an access token for your organisation's design systems
UpdatesWhen you update the command line or pluginAlways the portal's current build
Checks the running appYes, with pfdl_a11yNo

On your computer

node pfdl.mjs mcp

It reads pfdl.config.json in the folder it starts in for the design system and the portal's address. For your organisation's design systems, it uses Design Language Connect's sign-in, or PFDL_TOKEN when that's set. Only this server has pfdl_a11y, which checks pages in a browser on your computer. To get the command line, see The pfdl command line.

On the portal

Add a remote (HTTP) MCP server named pfdl with your portal's address followed by /mcp. The Any other AI tool card on the Connect page has a Copy MCP address button (/connect#other-ai).

Without a token, the server gives everyone's content and the built-in design systems. With an access token, sent as a header, it also gives your organisation's design systems and templates, and starts in the design system your admin chose for members:

{ "Authorization": "Bearer pfdl_…" }

Some portals require a token for every call. When yours does, the Connect page says "Your admin gives you an access token for this connection."

A few of the tools

  • pfdl_overview: what the design language is and the rules that always apply.
  • pfdl_search: components, templates, guidelines, tokens, icons and more.
  • pfdl_get_component: a component's exact props, usage and accessibility notes.
  • pfdl_get_tokens: semantic tokens in light, dark and high contrast.
  • pfdl_list_templates and pfdl_get_template: whole screens to start from, with their source.
  • pfdl_check: checks a file's code and copy against the rules.

If something goes wrong

If something goes wrong
What you seeWhat to do
"This MCP server needs an access token"Create one under More › Access tokens and send it as Authorization: Bearer <token>.
"That access token isn't valid any more"It expired or was revoked. Create a new one.
pfdl-data.json not foundDownload pfdl-data.json into the same folder as pfdl.mjs.
Your organisation's design systems are missingCheck the token, and ask your admin whether your plan includes design systems in AI tools.