For AI agents
Give your coding agent the live Pro catalog, licensed source, and exact install commands. Pick a way to connect, then follow the setup for your client.
Ways to connect
All three use the license key from your account. Most people connect the MCP server and add the skill.
Choose how to sign in
The MCP server takes two kinds of sign-in. Both use the beui_live_ license key from your account.
Your client opens a beUI Pro page. Enter your key once and select Authorize. The client gets an access token that renews on its own and never sees your key.
Your client sends the key in an Authorization header, read from BEUI_PRO_TOKEN. Use it for clients without OAuth, CI, and scripts.
Never commit your key, put it in source files, or paste it into a prompt or tool argument.
Set up the MCP server
Pick your client. The server address is https://mcp.beui.dev/pro/mcp.
Sign in with OAuth
Add the server. Add
--scope userto use it in every project.claude mcp add --transport http beui-pro https://mcp.beui.dev/pro/mcpIn Claude Code, run
/mcp, select beui-pro, then Authenticate.On the beUI Pro page, enter your license key and select Authorize.
Use a license key
Export
BEUI_PRO_TOKENin the shell you start Claude Code from, then add the server:claude mcp add-json beui-pro '{"type":"http","url":"https://mcp.beui.dev/pro/mcp","headers":{"Authorization":"Bearer ${BEUI_PRO_TOKEN}"}}'
Sign in with OAuth
Add the server, then sign in. Codex opens your browser.
codex mcp add beui-pro --url https://mcp.beui.dev/pro/mcp codex mcp login beui-proOn the beUI Pro page, enter your license key and select Authorize.
Use a license key
Export
BEUI_PRO_TOKENin the shell you start Codex from, then add the server:codex mcp add beui-pro --url https://mcp.beui.dev/pro/mcp --bearer-token-env-var BEUI_PRO_TOKEN
Sign in with OAuth
Add the server to
~/.cursor/mcp.json, or to.cursor/mcp.jsonfor one project.JSON.cursor/mcp.json{ "mcpServers": { "beui-pro": { "url": "https://mcp.beui.dev/pro/mcp" } } }In Cursor Settings, find beui-pro in the MCP list and sign in.
On the beUI Pro page, enter your license key and select Authorize.
Use a license key
Use this config instead. Cursor reads
BEUI_PRO_TOKENfrom the environment it started in.JSON.cursor/mcp.json{ "mcpServers": { "beui-pro": { "url": "https://mcp.beui.dev/pro/mcp", "headers": { "Authorization": "Bearer ${env:BEUI_PRO_TOKEN}" } } } }
Sign in with OAuth
In Claude, open Settings, then Connectors, and add a custom connector with the server address.
https://mcp.beui.dev/pro/mcpSelect Connect on the new connector.
On the beUI Pro page, enter your license key and select Authorize.
Use a license key
Claude connectors sign in with OAuth only.
Sign in with OAuth
Add the server address as a Streamable HTTP server. Clients with OAuth find the sign-in page on their own.
JSONmcp.json{ "mcpServers": { "beui-pro": { "url": "https://mcp.beui.dev/pro/mcp" } } }
Use a license key
If your client takes custom headers, send the key instead. Use your client's syntax for environment variables.
JSONmcp.json{ "mcpServers": { "beui-pro": { "url": "https://mcp.beui.dev/pro/mcp", "headers": { "Authorization": "Bearer ${BEUI_PRO_TOKEN}" } } } }
For client authors
- Transport
- Streamable HTTP
- Resource metadata
- https://mcp.beui.dev/.well-known/oauth-protected-resource/pro/mcp
- Authorization server
- https://mcp.beui.dev
- Scope
- mcp:read
- Flow
- Authorization code with PKCE (S256), dynamic client registration or client ID metadata documents, and rotating refresh tokens.
Check it works
Ask your agent to list beUI Pro components. It should call list_components and show your catalog.
Tools
- list_components
- Every block and template your license can install.
- search_components
- Find items by name or description.
- get_component
- Source files, dependencies, and the install command for one item.
- get_install_command
- The shadcn command and registry config for one item.
- list_mobile_components
- React Native blocks and screens, for Mobile licenses.
Install the Agent Skill
The skill tells your agent how to find the right blocks, install them, and fit them to your project's design system.
npx skills add starc007/ui-components --skill beui-proWith the MCP server connected, the skill needs nothing else. For CLI installs it reads BEUI_PRO_TOKEN.
Use the shadcn registry
Add the private registry to components.json, set BEUI_PRO_TOKEN, and install with the shadcn CLI. Your agent can run the same commands.
{
"registries": {
"@beui": "https://beui.dev/r/{name}.json",
"@beui-pro": {
"url": "https://pro.beui.dev/r/{name}.json",
"headers": {
"Authorization": "Bearer ${BEUI_PRO_TOKEN}"
}
}
}
}export BEUI_PRO_TOKEN="beui_live_xxxxxxxxxxxx"
npx shadcn@latest add @beui-pro/agent-chat-inputTroubleshooting
- The client says 401 or asks you to sign in
- With OAuth, sign in again:
/mcpin Claude Code,codex mcp login beui-proin Codex, or the MCP settings in Cursor. With a license key, check thatBEUI_PRO_TOKENis set where the client runs. - The beUI Pro page says the key is invalid
- Copy the key again from your account. It starts with
beui_live_. Expired or revoked licenses can't sign in. - The key is set but the client can't see it
- Apps read environment variables when they start. Restart the app, or start it from a terminal where
BEUI_PRO_TOKENis set. - An install returns 404
- The slug is out of date. Ask your agent to list or search components again and use the slug it returns.
- The mobile tool returns an error
list_mobile_componentsneeds a Mobile or Web + Mobile license.- The client only supports SSE
- The server uses Streamable HTTP only. Update the client or switch it to its HTTP transport.
- You want to use a different license
- Sign out, then sign in with the other key. In Codex run
codex mcp logout beui-pro. In other clients, remove the server and add it again.
Still stuck? Contact us.
Let your agent buy it
Agents can buy Lifetime Pro for 179 USDC, or a single template, with the Machine Payments Protocol on Solana mainnet. The agent needs an MPP payment client and a wallet with USDC and a little SOL for fees.
- The agent signs in with the wallet, which costs no gas.
- It requests the product and pays with MPP.
- Pro returns a license key; a template returns a ZIP download.
Read https://pro.beui.dev/components/agents.md and the linked payment catalog.
Buy beUI Pro Lifetime using my connected Solana wallet.
My purchase budget is 179 USDC. Show me the estimated SOL costs before paying.
Use native MPP and save the returned license key securely.Requesting the same product again with the same wallet recovers it without a second charge. To add the license to your dashboard, ask the agent for a claim code and enter it after signing in. Codes last ten minutes.