Bluestars

View saved version →

---
name: bluestars
description: >-
  Work with a Bluestars customer dashboard through the Bluestars MCP server:
  conversation analytics, usage/billing, BSR customer & visitor segmentation
  insights, postcode-to-segment lookups, BSR color-variant rewriting of copy,
  and the public REST API. Use when the user asks about their Bluestars data,
  widget conversations, BSR segments/personas, campaign results, rewriting copy
  per BSR segment, or Bluestars API usage.
---

<!-- GENERATED FILE, do not edit plugin/SKILL.md directly.
     Source: plugin/SKILL.template.md + src/lib/mcp/tool-catalog.ts
     + src/lib/content-platform/guidance/flows.ts.
     Regenerate: npm run generate-skill -w bs-sdk (runs in build:plugins too). -->

# Bluestars

Bluestars is a decision layer on top of a marketing stack: an embeddable AI
assistant (chat widget) plus BSR® psychographic segmentation of customers and
website visitors. This skill works against the **Bluestars MCP server**, which
exposes the same data the customer dashboard shows.

## Connecting

The MCP server lives at `https://bluestars.app/api/mcp` (Streamable HTTP).
Authentication is OAuth 2.1 with PKCE; the server supports both CIMD (URL
client IDs) and Dynamic Client Registration, so any modern MCP client can
connect without pre-registration. On first use you will be sent to the
Bluestars consent page: log in with your dashboard account (magic link) and
approve. Tokens carry exactly your dashboard permissions: tools for sections
you cannot see in the dashboard return a permission error.

## Orientation

Always call `get_started` first. It returns who you are on the account, its
plan, the setup checklist with the next step, and the flows the account can
use. Lead the user through any open setup step before anything else.
`get_account_info` adds the sections you can see and whether the tenant has a
public API key provisioned.

## Flows

Each flow is also an MCP prompt (a slash command in clients that show them),
and `get_workflow_guide` returns its steps.

- **`onboarding`**: Work through the open setup steps with the user, one at a time, explaining why each matters. (`get_started`, `set_website`, `set_site_type`, `get_widget_install_snippet`, `check_script_install`, `upload_customer_data`, `get_site_languages`, `confirm_site_languages`, `connect_google`, `check_google_access`)
- **`brand_setup`**: Collect the brand's own material, condense it into the guidelines every piece of content follows. (`save_knowledge`, `add_knowledge_reference`, `get_brand_guidelines_instructions`, `update_brand_guidelines`, `get_brand_guidelines`)
- **`create_content`**: Write one piece per BSR segment with Bluestars' instructions, and save it to the library. (`get_content_instructions`, `get_library_item`, `save_to_library`, `attach_variant_image`, `create_image_upload_url`)
- **`bulk_content`**: The create_content flow in a loop, for a list of products, pages or campaigns. (`get_content_instructions`, `save_to_library`)
- **`update_content`**: Find a piece in the library and write a new version of it. (`search_library`, `get_library_item`, `get_content_instructions`, `save_to_library`, `update_library_item`, `archive_library_item`)
- **`capture_knowledge`**: When the user states something reusable (a rule, a fact, a decision), offer to save it. (`search_knowledge`, `save_knowledge`, `get_knowledge_entry`, `archive_knowledge_entry`)
- **`use_global_knowledge`**: Look things up in the knowledge banks Bluestars shared with this account. (`list_knowledge_banks`, `search_knowledge`)

## Tools

| Tool                                | What it returns                                                                                                                                                                                       | Needs section |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------

Preview of the first 4,000 characters. Read full instructions →