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.
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
| On your computer | On the portal | |
|---|---|---|
| How | pfdl mcp, over stdio | https://<your portal>/mcp, over HTTP |
| Needs | Node.js 20 and the pfdl command line | The address, and an access token for your organisation's design systems |
| Updates | When you update the command line or plugin | Always the portal's current build |
| Checks the running app | Yes, with pfdl_a11y | No |
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_templatesandpfdl_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
| What you see | What 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 found | Download pfdl-data.json into the same folder as pfdl.mjs. |
| Your organisation's design systems are missing | Check the token, and ask your admin whether your plan includes design systems in AI tools. |