Replit connects to UI Rules in two parts: an MCP server integration, and a skill that tells Replit Agent when to use it. Both are workspace-wide, so this is a one-time setup for every project.

Prerequisites

A Replit account.
A UI Rules brand with styles and rules configured.
A connection key for the project you want to serve. Create one from Connect your AI tools on the project overview.

Add the MCP server

Open integrations

Click the Replit logo (top left), then Settings → Integrations, the Your integrations tab, and Add MCP server.

Fill in the form

Display name: UI Rules
MCP Server URL: https://mcp.uirules.com/mcp

Under Advanced settings click Add header, enter x-api-key as the name and your connection key as the value, then click Test & save.

Upload the skill

This step is not optional. The skill is what makes Replit Agent reach for UI Rules before it builds.

Download the skill file

In the UI Rules app, open Connect your AI tools, pick Replit, and click Download skill. It saves a file called SKILL.md.

Add it to Replit

Back in Settings → Integrations, click + Add → Upload a skill, choose the SKILL.md file, and click Create skill.

The skill is workspace-wide, so every project you open in Replit picks it up.

Troubleshooting

If Replit does not connect or ignores your brand, see Troubleshooting.

Apply your design system guidelines in Replit