MCP server

After adding the Loracle MCP server, your coding agent can search your component catalog with natural language.

Before you begin

An API key from the Loracle dashboard (Project Settings > API Keys)
A published design system (see the CLI guide)

Set up your IDE

Add the Loracle MCP endpoint to your IDE’s configuration. The server is hosted — no local installation required. Use the API key you copied from the Loracle dashboard. It starts with sk_live_.

Cursor
Claude Code
Windsurf

Add to .cursor/mcp.json in your project root:

.cursor/mcp.json

{
  "mcpServers": {
    "loracle": {
      "url": "https://mcp.getloracle.com",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Add a project-level server with the Claude Code CLI:

export LORACLE_API_KEY="sk_live_..."
claude mcp add --transport http loracle https://mcp.getloracle.com --header "Authorization: Bearer $LORACLE_API_KEY"

Or add it to .mcp.json in your project root:

.mcp.json

{
  "mcpServers": {
    "loracle": {
      "type": "http",
      "url": "https://mcp.getloracle.com",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "loracle": {
      "serverUrl": "https://mcp.getloracle.com",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Restart your IDE after saving the configuration.

Available tools

get_components

Search your design system catalog by natural language. Returns matching component names, props, and usage documentation.

get_components({ query: "button with loading state" })

Your coding agent calls this tool automatically when it needs to find components. You can also ask it directly — for example, “find a date picker component from our design system.”

Before you begin

Set up your IDE

Available tools

get_components

Next steps

Loracle CLI

Storybook addon

​Before you begin

​Set up your IDE

​Available tools

​get_components

​Next steps

Loracle CLI

Storybook addon

Before you begin

Set up your IDE

Available tools

get_components

Next steps