@primer/brand-mcp

A Model Context Protocol server that helps AI agents use Primer Brand (@primer/react-brand) correctly when building GitHub marketing and landing pages.

It is a version-aware, stdio (local) server which reads the docs and metadata of your installed @primer/react-brand dependency.

Tools

| Tool | What it does | | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | primer_brand_setup | Configures Primer Brand first-time and maintains a Primer Brand pointer beside the declaring package.json. | | primer_brand_page_design | Page-design conventions (header/footer, hero media, gridline aesthetic, card grids, metadata patterns) and the current-brand reference templates to start from. | | primer_brand_component | Get a component API information like props, allowed values and named sub-components. | | primer_brand_examples | Reference examples taken from our Storybook. | | primer_brand_tokens | Resolve design tokens by intent (color, space, typography) to CSS variables and values. | | primer_brand_asset | Find Octicons (@primer/octicons-react) and Octovisuals (@primer/octovisuals-react) more easily | | primer_brand_docs | Search and read Primer Brand guidance, including principles, accessibility and getting started. | | primer_brand_review | Check generated JSX and CSS against the design system for unknown components, invalid props, hardcoded values |

Getting started

Requires Node.js >= 24.

VS Code

{
  "servers": {
    "Primer Brand": {
      "type": "stdio",
      "command": "npx",
      "args": ["@primer/brand-mcp@latest"]
    }
  }
}

When an agent calls primer_brand_setup, the tool updates AGENTS.md only in a package whose package.json declares @primer/react-brand. Existing instructions are preserved. If several workspace packages declare the dependency, call setup with projectDir set to the intended workspace-relative package folder. The pointer routes future agents to the MCP tools and version-matched docs bundled with the installed package.

Copilot CLI / other stdio clients

Run the server with npx @primer/brand-mcp@latest.

License

MIT