All servers / Design / Primer MCP server
Primer MCP server
An MCP server that connects AI tools to the Primer Design System
Tested by ConnectATDScore 90 out of 100. Tested 2026-11-18 on package version 1.1.2. Package: @primer/mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 16 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 16 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (6.1 seconds including download)
- Tools offered: 20
- Last published: 2026-10-23
- Weekly downloads (npm): 15,244
- License: none listed · Direct dependencies: 8
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
initno parametersSetup or create a project that includes Primer React
list_componentsno parametersList all of the components available from Primer React
get_component1 of 1 parameter describedRetrieve official documentation and usage details for exactly one React component from the @primer/react package. Use get_component_batch for 2 to 10 components.
get_component_batch1 of 1 parameter describedRetrieve official documentation and usage details for 2 to 10 React components from the @primer/react package in one call. Use get_component for exactly one component.
get_component_examples1 of 1 parameter describedGet examples for how to use a component from Primer React
get_component_usage_guidelines1 of 1 parameter describedGet usage information for how to use a component from Primer
get_component_accessibility_guidelines1 of 1 parameter describedRetrieve accessibility guidelines and best practices for a specific component from the @primer/react package by its name. Use this tool to get official accessibility recommendations, usage tips, and requirements to ensure your UI components are inclusive and meet accessibility standards.
list_patternsno parametersList all of the patterns available from Primer React. Scenario patterns describe specific user tasks. Prefer a scenario pattern when one fits the task, and fall back to the more generic UI patterns otherwise.
get_pattern1 of 1 parameter describedGet a specific pattern by name. Scenario patterns describe specific user tasks. Prefer a scenario pattern when one fits the task, and fall back to the more generic UI patterns otherwise.
find_tokens3 of 3 parameters describedSearch for specific tokens. Tip: If you only provide a 'group' and leave 'query' empty, it returns all tokens in that category. Avoid property-by-property searching. COLOR RESOLUTION: If a user asks for "pink" or "blue", do not search for the color name. Use the semantic intent: blue->accent, red->danger, green->success. Always check both "emphasis" and "muted" variants for background colors. After identifying tokens and writing CSS, you MUST validate the result using lint_css.
get_token_group_bundle1 of 1 parameter describedPREFERRED FOR COMPONENTS. Fetch all tokens for complex UI (e.g., Dialogs, Cards) in one call by providing an array of groups like ['overlay', 'shadow']. Use this instead of multiple find_tokens calls to save context.
get_design_token_specsno parametersCRITICAL: CALL THIS FIRST. Provides the logic matrix and the list of valid group names. You cannot search accurately without this map.
get_token_usage_patternsno parametersProvides "Golden Example" CSS for core patterns: Button (Interactions) and Stack (Layout). Use this to understand how to apply the Logic Matrix, Motion, and Spacing scales.
lint_css0 of 1 parameter describedREQUIRED FINAL STEP. Use this to validate your CSS. You cannot complete a task involving CSS without a successful run of this tool.
get_color_usageno parametersGet the guidelines for how to apply color to a user interface
get_typography_usageno parametersGet the guidelines for how to apply typography to a user interface
list_iconsno parametersList all of the icons (octicons) available from Primer Octicons React
get_icon2 of 2 parameters describedGet a specific icon (octicon) by name from Primer
primer_coding_guidelinesno parametersGet the guidelines when writing code that uses Primer or for UI code that you are creating
review_alt_text3 of 3 parameters describedEvaluates image alt text against accessibility best practices and context relevance.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.