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 Code

Add the server with the CLI:


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

Installing the Agent Skill plugin connects the server for you, so you don’t need this command as well.

Claude.ai / Cowork / Desktop

Add a custom connector in settings and point it at the endpoint:


https://styleref.io/api/mcp

Do this even if you already installed the Agent Skill plugin. On these surfaces the plugin provides the skill, and the connector provides the tools — without it the agent can reason about styles but can’t fetch, save, or fork one.

Cursor

In Cursor’s MCP settings, add a server with an HTTP URL of:


https://styleref.io/api/mcp

VS Code

Add an HTTP MCP server pointing at the endpoint:


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

ChatGPT

In ChatGPT, add a custom connector (Settings → Connectors; requires a plan with connector support) with the server URL:


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.