​
Audience Demographic Analysis

This example demonstrates a simple workflow to retrieve and analyze audience demographics across social media platforms using the MCP server.

​
Basic Workflow

User: List all my users

AI: [Calls get-users-by-tenant-app]
Here are all your users:

1. John Smith (john.smith@example.com)
   - ID: user-123-abc-456-def
   - Created: January 15, 2025

2. Sarah Johnson (sarah.j@example.com)
   - ID: user-789-ghi-101-jkl
   - Created: February 3, 2025

User: List all user accounts Sarah Johnson has

AI: [Calls get-user-accounts with user_id]
Sarah Johnson (sarah.j@example.com) has the following user accounts:

1. Instagram
   - ID: acct-456-insta-789
   - Platform Account ID: 123456789012345
   - Last refreshed: May 10, 2025
   - Status: Active

2. LinkedIn
   - ID: acct-789-lnkd-012
   - Platform Account ID: LinkedIn123
   - Last refreshed: May 9, 2025
   - Status: Active

User: Get the demographics for Sarah's Instagram account

AI: [Calls get-account-demographics with user_account_id]
Here are the demographics for Sarah's Instagram account:

Gender Distribution:
- Female: 63%
- Male: 37%

Age Breakdown:
- 18-24 years: 20%
- 25-34 years: 42% (largest age group)
- 35-44 years: 25%
- 45-54 years: 10%
- 55+ years: 3%

Geographic Distribution:
- United States: 55%
- United Kingdom: 15%
- Canada: 10%
- Australia: 8%
- Other countries: 12%

User: Compare the demographics between Instagram and LinkedIn

AI: [Calls get-account-demographics for both accounts]
Here's a comparison of demographics between Sarah's Instagram and LinkedIn accounts:

Instagram:
- Gender: 63% Female, 37% Male
- Primary Age Group: 25-34 (42%)
- Top Location: United States (55%)

LinkedIn:
- Gender: 54% Female, 46% Male
- Primary Age Group: 35-44 (38%)
- Top Location: United States (62%)

Key Differences:
- LinkedIn audience is more balanced in gender distribution
- LinkedIn audience is generally older (38% in 35-44 age range)
- LinkedIn has a higher concentration of US-based followers
- Instagram has more international diversity in audience

​
Implementation Steps

To implement demographic analysis functionality, follow these simple steps:
  1. Get Users: Use get-users-by-tenant-app to retrieve all users
  2. Get User Accounts: Use get-user-accounts with the selected user’s ID to retrieve their connected social media accounts
  3. Get Demographics: Use get-account-demographics with the account ID to retrieve demographic data
  4. Get Age Breakdown: Use get-audience-age-breakdown with the account ID for detailed age distribution
  5. Present Analysis: Display the demographic data in a clear, organized format

​
Audience Demographic Data Types

When analyzing audience demographics, you can access these data types:
Data TypeDescriptionAvailable Breakdowns
GenderGender distribution of audienceMale, Female
AgeAge breakdown of audience18-24, 25-34, 35-44, 45-54, 55+
LocationGeographic distributionCountries, sometimes cities
InterestsInterest categories (when available)Varies by platform
Activity TimesPeak engagement times (when available)Time of day, day of week

​
Required MCP Tools

This implementation uses these tools:
  • get-users-by-tenant-app - Lists all users
  • get-user-accounts - Lists user’s social media accounts
  • get-account-demographics - Gets gender and location distribution
  • get-audience-age-breakdown - Gets detailed age demographic data

​
Advanced Analysis Techniques

Here are some ways to derive deeper insights from demographic data:
  1. Cross-Platform Comparison: Compare demographics across different platforms to identify platform-specific strategies
  2. Content Performance by Demographic: Analyze which content performs best with specific demographic segments
  3. Demographic Trend Analysis: Track changes in demographics over time to identify growing audience segments
  4. Audience-Content Alignment: Ensure content strategy aligns with the preferences of key demographic groups
  5. Competitive Benchmarking: Compare your audience demographics to industry standards or competitors

​
Prompt Engineering Tips

When designing prompts for your AI assistant to handle demographic analysis, consider:
  1. Data visualization descriptions - Describe charts or graphs in text to make the data more understandable
  2. Comparative analysis - Enable comparisons between platforms, time periods, or industry benchmarks
  3. Actionable insights - Don’t just present data; explain what it means and how to use it
  4. Personalization level - Allow users to request different levels of detail or focus areas
  5. Market-specific context - Consider regional or cultural context when interpreting demographic data