What is the Carbon MCP server?
Carbon MCP runs on IBM Cloud and gives any MCP client access to Carbon component code, icons, charts and documentation. Connect with a URL and sign in with an IBMid, then an AI coding agent can audit code against Carbon guidelines, search examples, and pull chart code for several frameworks.
Carbon MCP is a hosted server that gives an AI coding agent direct access to Carbon Design System components, icons, charts and documentation. It runs on IBM Cloud, so any MCP client connects with a URL instead of running local code.
The repository itself is where issues and feature requests go, and where the companion Carbon Builder skill is published. The server content keeps growing as more of the design system gets indexed.
Tool coverage
| Tool | What it returns |
|---|---|
| code_audit | A check of generated code against Carbon guidelines |
| code_search | Carbon React and web component code examples, icons and pictograms |
| docs_search | Carbon Design System and IBM Products documentation |
| get_charts | Carbon Charts code examples across several frameworks |
| labs_search | Code examples and usage docs for Carbon Labs experimental components |
What it changes in your workflow
- An agent queries live component source, props and usage guidance instead of guessing at Carbon's conventions.
- Generated code can be checked against Carbon guidelines with one tool call before it ships.
- Designers, developers and product managers get the same answers from one shared server instead of drifting apart.
- Pairing the server with the Carbon Builder skill adds rules for when to ask the server for facts.
Who it is for
Best for
- Teams already building on Carbon React or web components who want an agent that writes to the system correctly.
- Organizations with an IBMid who are comfortable signing in to a hosted server rather than running one locally.
- Anyone who wants chart code for React, Angular, Vue, Svelte or plain HTML generated from one source.
Not for
- If your job is mostly building against monday.com's own design system instead of Carbon, the Vibe MCP server is the better fit for that.
- If your job is mostly pulling a live icon set for a Svelte project, shadcn-svelte MCP is the better fit for that.
- If your job is mostly installing animated React components from a separate library, Lightswind UI MCP Server is the better fit for that.
- If your job is mostly pulling design tokens from many sources for a mood board, Frontend Inspo MCP is the better fit for that.
Connect Carbon MCP Server: Carbon Design System for AI Agents to your AI client
Add https://mcp.carbondesignsystem.com/mcp as a remote server and sign in with an IBMidAdd the remote server
Add the config above to a client that reads an mcp.json entry, or follow the onboarding guide for Claude Desktop, Cursor, Figma Make or Claude Code.
Sign in
Authenticate with an IBMid when your client prompts for it. Clients without OAuth discovery can use a token and session ID instead.
Install the Carbon Builder skill
Pair the server with the Carbon Builder skill so the agent knows when to ask the server for component and token facts.
Try a prompt
Ask for a button and tabs example in Carbon React, then ask the audit tool to check the result against Carbon guidelines.
Client configuration
{
"mcpServers": {
"carbon-mcp": {
"type": "streamable-http",
"url": "https://mcp.carbondesignsystem.com/mcp",
"oauth": true,
"alwaysAllow": []
}
}
}What you can do with it
- Hosted, no local processThe server runs on IBM Cloud, so a client connects with a URL and an IBMid sign-in instead of installing or running anything locally.
- Direct Carbon accessAn agent queries colors, typography, component source and usage guidelines straight from the Carbon Design System instead of inferring them.
- Code audit against guidelinesThe code_audit tool checks generated code for design tokens, component usage, accessibility and layout against Carbon's own practice.
- Charts across frameworksget_charts returns chart code and demo links for React, Angular, Vue, Svelte, Vanilla JS and HTML from one tool.
- Carbon Labs coveragelabs_search reaches experimental Carbon Labs components, with props, events and usage docs alongside the stable component set.
- Carbon Builder skill pairingAn installable skill tells the agent when to call the server for facts and how to turn the answers into working code.
- Several client onboarding pathsSetup guidance covers IBM Bob, Cursor, Figma Make, desktop agent apps and other MCP clients, including a token-based path for ones without OAuth.
Tools it exposes
code_audit
Checks code against Carbon guidelines covering design tokens, component usage, accessibility, layout and best practices.
code_search
Returns Carbon React and web component code examples, icons and pictograms, including full example application code.
docs_search
Returns Carbon Design System and IBM Products documentation, such as component guidance and accessibility reference material.
get_charts
Returns Carbon Charts code examples for React, Angular, Vue, Svelte, Vanilla JS and HTML.
labs_search
Returns code examples, props, events and usage docs for Carbon Labs experimental components.
Frequently asked questions
What is the Carbon MCP server?
It is a hosted server that gives an AI coding agent direct access to the Carbon Design System: component code, icons, charts and documentation. It runs on IBM Cloud, so a client connects with a URL and an IBMid instead of running local code.
How do I connect to the Carbon MCP server?
Add the hosted URL to a client that reads mcp.json, or follow the onboarding steps for your specific client. Sign in with an IBMid when prompted. Clients that cannot do OAuth discovery can authenticate with a token and session ID instead.
What tools does Carbon MCP provide?
Five tools: code_audit checks generated code against Carbon guidelines, code_search and docs_search return component examples and documentation, get_charts returns chart code for several frameworks, and labs_search covers experimental Carbon Labs components.
Does Carbon MCP need an account?
Yes. It is a hosted service, so a client signs in with an IBMid through OAuth, or with a token and session ID generated from the server's auth page for clients that cannot do OAuth discovery.
What is the Carbon Builder skill?
It is a companion skill published in the same repository that turns an agent into a Carbon Design System engineer. It retrieves examples and documentation through Carbon MCP and generates Carbon React, web component and chart code.
Which AI coding agents work with Carbon MCP?
The onboarding guide lists IBM Bob, Claude Desktop, Cursor, Figma Make, Claude Code, VS Code and GitHub Copilot. Any MCP client that supports a hosted streamable-http server with OAuth should be able to add the same connection.
Does Carbon MCP cover every Carbon component?
Coverage keeps growing. Today it indexes core React and web components, Carbon for IBM Products patterns, icons and pictograms, the AI chat pattern, Carbon Charts, and a set of Carbon Labs preview components.


