developer-toolsapi_key

Bluebarry

Bluebarry is a customer data and product-advice platform for analyzing and synchronizing shopper identities and profiles.

Verdict

Bluebarry tracks shopper identity across sessions and devices, merging anonymous browsing into known customer profiles. In Switchy, @mention Bluebarry to pull identity records and raw profile data — useful for support teams diagnosing account merge issues, marketing ops auditing attribution, or product managers analyzing cross-device behavior. The MCP exposes two tools: one lists deduplicated shopper identities (the 'golden record'), the other lists raw unmerged profiles (session-level detail). Pagination works via offset or cursor depending on whether you set a limit. You'll need an API key from your Bluebarry dashboard.

Common use cases

  • Debug why two accounts merged incorrectly
  • Audit attribution for a campaign cohort
  • Trace a shopper's journey across devices
  • Export identity data for compliance requests
  • Analyze session frequency before conversion

Integration

Vendor
Bluebarry
Category
developer-tools
Auth
API_KEY
Tools
2
Composio slug
bluebarry

Tools

  • List Identities

    Return shopper identity records. With limit, page by increasing offset; without limit, follow next_cursor when present. Filter mergedIntoId eq null for surviving identities. Incremental sync must overlap updatedDate windows and upsert by id

  • List Profiles

    Return raw, unmerged profile rows. With limit, page by increasing offset; without limit, follow next_cursor when present. Use this for per-session or per-user detail because one shopper can appear in multiple rows.

Setup

Setup guide

  1. 11. In Switchy, open Settings → Integrations and click Connect next to Bluebarry. 2. You'll see a prompt for an API key — grab yours from the Bluebarry dashboard under API Access or Developer Settings. 3. Paste the key into Switchy and click Authorize. 4. Switchy confirms the connection and shows 'Bluebarry connected' with a green badge. 5. Open any Project, type '@Bluebarry list identities with limit 10' in the chat, and press Enter. 6. If you see a JSON array of shopper records, the integration works. 7. To filter for active identities only, add 'where mergedIntoId is null' to your prompt. 8. For session-level detail, use '@Bluebarry list profiles' instead — this returns raw, unmerged rows tied to individual visits.

What teammates see: by default, memories from Bluebarry are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Recent Identity Changes

@Bluebarry list identities with limit 50, ordered by most recent update. Show me the shopper ID, email if present, and mergedIntoId status.

Active Shoppers Only

@Bluebarry list identities where mergedIntoId is null. Return the first 100 records with shopper ID and any linked email.

Session-Level Profile Dump

@Bluebarry list profiles with limit 200. Include session timestamp, device type, and any associated shopper ID.

Trace Single Shopper History

@Bluebarry list identities where email contains 'customer@example.com', then list profiles for that shopper ID. Show me the timeline.

Incremental Sync Check

@Bluebarry list identities without a limit, follow next_cursor if present. Filter mergedIntoId eq null and return records updated in the last 24 hours.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@bluebarry list the last 50 shopper identities that haven't been merged into another record, so I can see our active user base.

Output

Bluebarry returned 50 identity records with mergedIntoId set to null. Each entry includes an identity ID, creation timestamp, and associated profile count. For example, identity `ident_a1b2c3` was created on 2024-01-15 and links to 3 profiles. The response includes a next_cursor token you can use to fetch the next page if you need more than 50 records. This snapshot represents distinct shoppers who have not been consolidated into other identities.

Notes

This example uses the List Identities tool with a mergedIntoId filter to surface only surviving shopper records. Bluebarry requires an API key with read access to identity data. If your account has thousands of identities, you'll need to paginate using the offset or cursor pattern—this example shows a single page of 50.

Prompt

@bluebarry show me the raw profile rows for shopper identity ident_x9y8z7, including session-level details, so I can debug why this user appears twice in our analytics.

Output

Bluebarry returned 2 profile records linked to identity ident_x9y8z7. Profile 1 was created on 2024-02-10 from session sess_abc123 with user-agent Mozilla/5.0 (iPhone). Profile 2 was created on 2024-02-12 from session sess_def456 with user-agent Chrome/120. Both profiles share the same email but originated from different devices. This explains the duplicate appearance—Bluebarry tracks each session separately before merging them into a single shopper identity.

Notes

This example uses the List Profiles tool to drill into per-session data for a single identity. It's useful when you need to understand how a shopper's activity was captured across multiple visits or devices. Be aware that profile data can be verbose if a shopper has many sessions—filter by identity ID to keep the response manageable.

Prompt

@bluebarry pull all profiles created in the last 7 days and summarize the top 3 traffic sources by profile count, so I can see where our new shoppers are coming from.

Output

Bluebarry returned 342 profiles created between 2024-03-01 and 2024-03-08. Analyzing the referrer and UTM fields, the top 3 traffic sources are: (1) Google Ads—118 profiles, (2) Organic search—97 profiles, (3) Instagram—64 profiles. The remaining 63 profiles came from direct traffic or other sources. This breakdown shows paid search is currently your largest acquisition channel, followed closely by organic discovery. You may want to investigate the Instagram cohort's conversion rate separately.

Notes

This example combines Bluebarry's List Profiles tool with AI reasoning to aggregate and rank traffic sources. The MCP returns raw profile rows; the AI parses referrer metadata and counts occurrences. Bluebarry does not natively compute these summaries, so the analysis depends on the AI's ability to process the returned data. Large date ranges may hit API rate limits or return thousands of profiles—narrow the window if performance becomes an issue.

Use-case deep-dives

E-commerce fraud investigation at checkout

When Bluebarry helps support teams trace suspicious orders

A 6-person customer support team at a Shopify store sees a spike in chargebacks from accounts that look legitimate at first glance. Bluebarry's identity merge gives them a way to pull all profiles tied to a single shopper—across sessions, devices, and email variants—so they can spot patterns like multiple failed payment attempts or address mismatches before approving high-value orders. The two-tool setup (list identities, list profiles) is narrow enough that non-technical support leads can run queries without waiting on engineering. This works when your fraud volume is under 50 cases a week; beyond that, you need a dedicated fraud platform with real-time scoring, not a manual lookup MCP. If you're triaging chargebacks in Slack and want to pull shopper history without opening your analytics dashboard, Bluebarry closes that gap.

Marketing attribution for repeat buyers

Why this MCP falls short for campaign performance analysis

A 3-person growth team wants to understand which acquisition channels drive repeat purchases, so they consider using Bluebarry to merge anonymous sessions into known buyer profiles. The problem: Bluebarry only exposes identity and profile listing—it doesn't surface campaign UTMs, referral sources, or conversion events. You can see that shopper ID 12345 has three profiles, but you can't tie those profiles back to the Facebook ad or email campaign that brought them in. For attribution work, you need an MCP that integrates with your analytics warehouse (like Snowflake or BigQuery) or your marketing stack (like Segment). Bluebarry is built for identity resolution, not funnel analysis. If your question is 'who is this person across sessions,' it works; if your question is 'which campaign converted them,' look elsewhere.

Customer success account health scoring

When Bluebarry helps CS teams spot at-risk accounts early

A 4-person customer success team at a B2B SaaS company uses Bluebarry to track how many distinct users from a single organization are logging in each month. By listing profiles filtered to a customer's domain, they can see if engagement is concentrated in one person (a churn risk) or spreading across the team (a healthy sign). The API key auth and two-tool scope make this safe to run from a shared Switchy workspace without exposing sensitive customer data beyond identity records. This works for accounts with 5 to 500 users; smaller accounts don't generate enough profile volume to matter, and enterprise accounts need a proper product analytics tool with cohort tracking. If you're doing quarterly business reviews and want a quick pulse on account activity without building a dashboard, Bluebarry gives you that in two queries.

Frequently asked

What does the Bluebarry MCP do in Switchy?

It pulls shopper identity and profile data from Bluebarry's customer data platform into your Switchy workspace. You can query merged identity records to see which shoppers are the same person across sessions, or fetch raw profile rows for granular per-visit analysis. Useful for support teams investigating user journeys or data teams building audience segments without writing API code.

Do I need admin access to connect Bluebarry?

You need an API key with read access to identities and profiles. Bluebarry doesn't use OAuth, so whoever generates the key in your Bluebarry dashboard can paste it into Switchy. Check with your engineering or data team if you're unsure who controls API credentials—most orgs restrict these to admins or data platform owners.

Can the Bluebarry MCP write data or trigger merges?

No. It only reads identity and profile records. You can't create new profiles, force identity merges, or update shopper attributes through this MCP. If you need write operations, use Bluebarry's REST API directly or ask your engineering team to build a custom integration.

How is this different from querying Bluebarry's API myself?

The MCP handles pagination, cursor logic, and incremental sync filters for you. Instead of writing offset loops or parsing next_cursor tokens in code, you ask Switchy in plain English and it returns the data. Faster for ad-hoc questions; less flexible than a full API client if you need complex joins or scheduled exports.

Who on the team should connect this MCP?

Whoever needs to answer customer identity questions without waiting on engineering. Support leads investigating duplicate accounts, marketing ops building audience lists, or product managers exploring user behavior patterns are typical users. One person connects it; the whole workspace can query it, subject to your Switchy seat permissions.

More developer tools MCPs

See all developer tools MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.