Connect your agent

Connect with one URL

Pebble’s MCP is hosted, so there is nothing to download or run. Give your agent this one address and it can see every component, Free and Pro: names, descriptions, props, variants, usage examples, build guides, preview images, design tokens and guidelines.

https://pebbleui.com/mcp

Set up by agent

Every client takes the same URL. Use the first block for Free, or the token version for Pro source.

claude mcp add --transport http pebble https://pebbleui.com/mcp

claude mcp add --transport http pebble https://pebbleui.com/mcp \
  --header "Authorization: Bearer YOUR_PEBBLE_TOKEN"

{
  "mcpServers": {
    "pebbleui": {
      "url": "https://pebbleui.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "pebbleui": {
      "url": "https://pebbleui.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PEBBLE_TOKEN}"
      }
    }
  }
}

{
  "servers": {
    "pebbleui": {
      "type": "http",
      "url": "https://pebbleui.com/mcp"
    }
  }
}

{
  "servers": {
    "pebbleui": {
      "type": "http",
      "url": "https://pebbleui.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:pebble-token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "pebble-token",
      "description": "Pebble token",
      "password": true
    }
  ]
}

[mcp_servers.pebbleui]
url = "https://pebbleui.com/mcp"

[mcp_servers.pebbleui]
url = "https://pebbleui.com/mcp"
bearer_token_env_var = "PEBBLE_TOKEN"

{
  "mcpServers": {
    "pebbleui": {
      "httpUrl": "https://pebbleui.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "pebbleui": {
      "httpUrl": "https://pebbleui.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PEBBLE_TOKEN"
      }
    }
  }
}

mcp_servers:
  pebbleui:
    url: "https://pebbleui.com/mcp"

mcp_servers:
  pebbleui:
    url: "https://pebbleui.com/mcp"
    headers:
      Authorization: "Bearer YOUR_PEBBLE_TOKEN"

https://pebbleui.com/mcp

What your agent can do

“Find a compact confirmation control, explain its keyboard behavior, and show me how to install it.”

Pro access

Everyone can read every component’s details without an account. Only Pro source code requires a purchase and a valid token. Without them, your agent is told how to get access. Pebble Pro is currently available to customers in the United States. Free components, the docs and the MCP’s Free features stay available worldwide.

Sign in and open your account’s MCP tab to create a token. A token does not unlock Pro without a purchase. Tokens expire after 90 days and can be revoked. Keep yours in your client’s private configuration, never in an agent conversation or a committed file. ChatGPT does not support token headers, so it is Free only.

Request limits

The MCP allows 120 requests a minute per IP address without a token, and 600 a minute per token. Source downloads allow 60 and 300. If you pass a limit, the reply says how many seconds to wait.

Use the shadcn registry

Free components also work with the shadcn CLI, so you can add one straight to your project. Pro components are not in the registry.

npx shadcn@latest add https://pebbleui.com/r/button.json

Run it locally

You never need to, but @pebbleui/mcp can also run on your own machine over stdio, with the catalog bundled. The package is not publicly published yet, so the hosted URL is the way to connect today.