• DATA GAP
  • COUNT MISMATCH
  • USER AUDIT
  • HUMAN ACTION

How to troubleshoot user segment membership with your AI

Connect your Customer.io account to your AI client to audit your audience data. You can then pinpoint exactly why a user isn't hitting a specific segment.

Ask AI about this page

Short answer

Why isn't a user in my segment?

Your AI can pull specific user details and segment lists to find the mismatch. It compares the user's current attributes against your segment rules to find the broken link. You'll get a clear view of the data gaps causing the issue.

Where every issue lands.

Troubleshooting outcomes

The AI sorts your investigation into these specific areas.

DATA GAP

Missing attributes

The AI identifies which specific user properties are missing or incorrectly formatted. You'll see exactly what's preventing a match.

COUNT MISMATCH

Segment size check

The AI compares total segment counts against expected numbers. This helps you spot if a segment is unexpectedly empty or too large.

USER AUDIT

Individual verification

The AI looks at a single user's profile to see why they failed a segment rule. You get a direct comparison of their data versus the segment criteria.

HUMAN ACTION

Manual fixes needed

The AI flags where data is wrong but can't change it. You'll know exactly which records need manual updates in your Customer.io dashboard.

The workflow

What your AI does when the issue arrives.

Instead of clicking through menus, you just describe the problem to your agent.

  1. Identify the segment

    The AI finds the specific segment you're worried about to get its current definition and size.

    list_audience_segments

  2. Check segment members

    It pulls a list of people currently in that segment to verify the population.

    list_segment_members

  3. Inspect user profiles

    The AI looks at the specific attributes of a user who should be in the segment but isn't.

    get_customer_details

  4. Diagnose the error

    The AI compares the user's data against the segment logic to find the mismatch.

    get_customer_detailslist_audience_segments

Try it

Copy these to start.

Use these prompts to kick off your investigation.

Starting points

Swap out the segment names and email addresses for your actual Customer.io data.

Customer.io Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_pB5Glq19S2AlhJCYRGobJWZEWZYTGA1BNGjmWvM6/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Customer.io capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "customerio-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_pB5Glq19S2AlhJCYRGobJWZEWZYTGA1BNGjmWvM6/mcp"
    }
  }
}
Copy into chat04

  • Why isn't user test@example.com in my 'VIP Customers' segment?

  • List all segments in my Customer.io account so I can pick one to audit.

  • Show me the attributes for user user_123 to see why they aren't in the 'Churn Risk' segment.

  • How many users are currently in the 'New Signups' segment?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Customer.io once, then ask.

One connection gives your AI access to your audience data. Your login stays encrypted and secure on our end.

Connect Customer.io to your AI

FAQ

How this task behaves

  • 01

    Can the AI fix a user's attribute for me?

    No. The AI can only read your data to find errors. You have to go into Customer.io to actually change a user's attributes.

  • 02

    Can the AI create new segments?

    No. The AI can list and inspect existing segments, but it cannot create or delete segments in your account.

  • 03

    Does the AI see all my customer data?

    The AI only sees the data it needs to answer your specific questions using the available tools.

  • 04

    Can I use this to trigger a message?

    No. This specific task is for auditing and troubleshooting. It doesn't have the capability to send messages or trigger workflows.

  • 05

    How does the AI know why a segment rule failed?

    It uses the data from your user profiles to compare against the segment's logic, identifying exactly which attribute is causing the mismatch.

  • More questions about Customer.io? See everything the Customer.io Connector can do

Connect Customer.io to Claude, Cursor, ChatGPT & more