Connect your client

This guide connects an MCP client to the StyleRef server and verifies it with a first search_styles call. By the end, your agent can search, fetch, and apply styles.

Endpoint

https://styleref.io/api/mcp

The server speaks Streamable HTTP, is stateless, and exposes anonymous read tools — no login is required to search, fetch, and apply public styles. Account-scoped tools (save, fork, create, extract, publish) prompt you to connect your StyleRef account over OAuth; see Authentication & scopes.

Connect per client

claude mcp add --transport http styleref https://styleref.io/api/mcp

https://styleref.io/api/mcp

https://styleref.io/api/mcp

{
  "servers": {
    "styleref": {
      "type": "http",
      "url": "https://styleref.io/api/mcp"
    }
  }
}

https://styleref.io/api/mcp

Verify

Ask the agent to search StyleRef, or invoke the tool directly:

Use search_styles to find "warm editorial" styles.

A working connection returns a short list of style cards — name, slug, @handle, essence, and URL. Feed a slug to get_style or apply_style_to_prompt next.

Next steps

• Tools reference — every tool, with parameters and examples.
• Resources & prompts — browseable data and reusable prompts.
• Authentication & scopes — connect your account for write actions.