Audiense Insights MCP Server
OfficialThe Audiense Insights MCP Server enables programmatic access to marketing insights and audience analysis data, allowing you to:
Retrieve and list available Audiense insights reports
Access detailed information about specific reports, including status, segmentation, and audience size
Analyze aggregated audience insights (demographics, behavioral traits, psychographics, socioeconomic factors)
Compare audience influencers with baseline audiences, including affinity scores and uniqueness metrics
Extract content engagement data (liked, shared, and influential content)
Retrieve lists of available baseline audiences and affinity categories
Generate comprehensive report summaries with segment analysis, top insights, and influencers per segment
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Audiense Insights MCP Server get audience insights for report ID 12345"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
⚠️ Deprecated
Related MCP server: Mailchimp Universal MCP Server
🚫 This repository is no longer maintained.
The Audiense Insights MCP has been migrated to a remote model. For more information on how to use the new remote MCP, please reach us at support@audiense.com.
🏆 Audiense Insights MCP Server
This server, based on the Model Context Protocol (MCP), allows Claude or any other MCP-compatible client to interact with your Audiense Insights account. It extracts marketing insights and audience analysis from Audiense reports, covering demographic, cultural, influencer, and content engagement analysis.
🚀 Prerequisites
Before using this server, ensure you have:
Node.js (v18 or higher)
Claude Desktop App
Audiense Insights Account with API credentials
X/Twitter API Bearer Token (optional, for enriched influencer data)
⚙️ Configuring Claude Desktop
Open the configuration file for Claude Desktop:
MacOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
code %AppData%\Claude\claude_desktop_config.json
Add or update the following configuration:
"mcpServers": { "audiense-insights": { "command": "npx", "args": [ "-y", "mcp-audiense-insights" ], "env": { "AUDIENSE_CLIENT_ID": "your_client_id_here", "AUDIENSE_CLIENT_SECRET": "your_client_secret_here", "TWITTER_BEARER_TOKEN": "your_token_here" } } }Save the file and restart Claude Desktop.
🛠️ Available Tools
📌 get-reports
Description: Retrieves the list of Audiense insights reports owned by the authenticated user.
Parameters: None
Response:
List of reports in JSON format.
📌 get-report-info
Description: Fetches detailed information about a specific intelligence report, including:
Status
Segmentation type
Audience size
Segments
Access links
Parameters:
report_id(string): The ID of the intelligence report.
Response:
Full report details in JSON format.
If the report is still processing, returns a message indicating the pending status.
📌 get-audience-insights
Description: Retrieves aggregated insights for a given audience, including:
Demographics: Gender, age, country.
Behavioral traits: Active hours, platform usage.
Psychographics: Personality traits, interests.
Socioeconomic factors: Income, education status.
Parameters:
audience_insights_id(string): The ID of the audience insights.insights(array of strings, optional): List of specific insight names to filter.
Response:
Insights formatted as a structured text list.
📌 get-baselines
Description: Retrieves available baseline audiences, optionally filtered by country.
Parameters:
country(string, optional): ISO country code to filter by.
Response:
List of baseline audiences in JSON format.
📌 get-categories
Description: Retrieves the list of available affinity categories that can be used in influencer comparisons.
Parameters: None
Response:
List of categories in JSON format.
📌 compare-audience-influencers
Description: Compares influencers of a given audience with a baseline audience. The baseline is determined as follows:
If a single country represents more than 50% of the audience, that country is used as the baseline.
Otherwise, the global baseline is used.
If a specific segment is selected, the full audience is used as the baseline.
Each influencer comparison includes:
Affinity (%) – How well the influencer aligns with the audience.
Baseline Affinity (%) – The influencer’s affinity within the baseline audience.
Uniqueness Score – How distinct the influencer is compared to the baseline.
Parameters:
audience_influencers_id(string): ID of the audience influencers.baseline_audience_influencers_id(string): ID of the baseline audience influencers.cursor(number, optional): Pagination cursor.count(number, optional): Number of items per page (default: 200).bio_keyword(string, optional): Filter influencers by bio keyword.entity_type(enum:person|brand, optional): Filter by entity type.followers_min(number, optional): Minimum number of followers.followers_max(number, optional): Maximum number of followers.categories(array of strings, optional): Filter influencers by categories.countries(array of strings, optional): Filter influencers by country ISO codes.
Response:
List of influencers with affinity scores, baseline comparison, and uniqueness scores in JSON format.
📌 get-audience-content
Description: Retrieves audience content engagement details, including:
Liked Content: Most popular posts, domains, emojis, hashtags, links, media, and a word cloud.
Shared Content: Most shared content categorized similarly.
Influential Content: Content from influential accounts.
Each category contains:
popularPost: Most engaged posts.topDomains: Most mentioned domains.topEmojis: Most used emojis.topHashtags: Most used hashtags.topLinks: Most shared links.topMedia: Shared media.wordcloud: Most frequently used words.Parameters:
audience_content_id(string): The ID of the audience content.
Response:
Content engagement data in JSON format.
📌 report-summary
Description: Generates a comprehensive summary of an Audiense report, including:
Report metadata (title, segmentation type)
Full audience size
Detailed segment information
Top insights for each segment (bio keywords, demographics, interests)
Top influencers for each segment with comparison metrics
Parameters:
report_id(string): The ID of the intelligence report to summarize.
Response:
Complete report summary in JSON format with structured data for each segment
For pending reports: Status message indicating the report is still processing
For reports without segments: Message indicating there are no segments to analyze
💡 Predefined Prompts
This server includes a preconfigured prompts
audiense-demo: Helps analyze Audiense reports interactively.segment-matching: A prompt to match and compare audience segments across Audiense reports, identifying similarities, unique traits, and key insights based on demographics, interests, influencers, and engagement patterns.
Usage:
Accepts a reportName argument to find the most relevant report.
If an ID is provided, it searches by report ID instead.
Use case: Structured guidance for audience analysis.
🛠️ Troubleshooting
Tools Not Appearing in Claude
Check Claude Desktop logs:
tail -f ~/Library/Logs/Claude/mcp*.logVerify environment variables are set correctly.
Ensure the absolute path to index.js is correct.
Authentication Issues
Double-check OAuth credentials.
Ensure the refresh token is still valid.
Verify that the required API scopes are enabled.
📜 Viewing Logs
To check server logs:
For MacOS/Linux:
tail -n 20 -f ~/Library/Logs/Claude/mcp*.logFor Windows:
Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20🔐 Security Considerations
Keep API credentials secure – never expose them in public repositories.
Use environment variables to manage sensitive data.
📄 License
This project is licensed under the Apache 2.0 License. See the LICENSE file for more details.
Available Tools
8 toolscompare-audience-influencersB
Compares the influencers of an audience with a baseline audience. The baseline is determined as follows: If the selection was the full audience and a single country represents more than 50% of the audience, that country is used as the baseline. Otherwise, the Global baseline is applied. If the selection was a specific segment, the full audience is used as the baseline. Each influencer comparison includes: - Affinity (%) - The level of alignment between the influencer and the audience. Baseline Affinity (%) - The influencer’s affinity within the baseline audience. Uniqueness Score - A measure of how distinct the influencer is within the selected audience compared to the baseline.
Inputs: audience_influencers_id (required), baseline_audience_influencers_id (required), cursor, count, +6 more.
get-audience-contentC
Retrieves audience content engagement details for a given audience.
This tool provides a detailed breakdown of the content an audience interacts with, including:
Liked Content: Popular posts, top domains, top emojis, top hashtags, top links, top media, and a word cloud.
Shared Content: Content that the audience shares, categorized similarly to liked content.
Influential Content: Content from influential accounts that impact the audience, with similar categorization.
Each category contains:
popularPost: List of the most engaged posts.
topDomains: Most mentioned domains.
topEmojis: Most used emojis.
topHashtags: Most used hashtags.
topLinks: Most shared links.
topMedia: Media types shared and samples.
wordcloud: Frequently used words.
Inputs: audience_content_id (required).
get-audience-insightsC
Retrieves aggregated insights for a given audience ID, providing statistical distributions across various attributes. Available insights include demographics (e.g., gender, age, country), behavioral traits (e.g., active hours, platform usage), psychographics (e.g., personality traits, interests), and socioeconomic factors (e.g., income, education status).
Inputs: audience_insights_id (required), insights.
get-baselinesC
Retrieves available baselines, optionally filtered by country.
Inputs: country.
get-categoriesA
Retrieves the list of available affinity categories that can be used as the categories parameter in the compare-audience-influencers tool.
Inputs: no named parameters.
get-report-infoB
Retrieves detailed information about a specific intelligence report, including its status, segmentation type, audience size, segments, and access links.
Inputs: report_id (required).
get-reportsB
Retrieves the list of Audiense insights reports owned by the authenticated user.
Inputs: no named parameters.
report-summaryC
Generates a comprehensive summary of an Audiense report, including segment details, top insights, and influencers.
Inputs: report_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose with no overlap: compare-audience-influencers focuses on influencer comparisons, get-audience-content on content engagement, get-audience-insights on aggregated statistics, get-baselines on baseline data, get-categories on affinity categories, get-report-info on report metadata, get-reports on report listings, and report-summary on report summarization. The descriptions reinforce these distinct roles, making tool selection unambiguous.
All tool names follow a consistent kebab-case pattern with a verb-noun structure (e.g., get-audience-insights, compare-audience-influencers). The verbs are appropriate and predictable (get, compare, report), and there are no deviations in naming style or convention across the set.
With 8 tools, this server is well-scoped for an audience insights domain. The count is neither too sparse nor bloated, covering core operations like retrieving insights, content, reports, and comparisons without redundancy. Each tool serves a specific, necessary function in the workflow.
The tool set provides comprehensive coverage for analyzing audience insights, including retrieval of reports, insights, content, and comparisons. Minor gaps exist, such as the lack of tools for creating or updating reports or audiences, which might limit full lifecycle management. However, the available tools support most common analysis tasks effectively.
Maintenance
Related MCP Connectors
Minds is a synthetic market research platform. This MCP server lets ChatGPT, Claude, and Cursor build Audiences from a brief, run durable Studies and Question Blocks, compare segments, and export results. OAuth 2.1 or Minds API key.
Read-only access to InfluSense influencer discovery, ratings, watchlists, and reports via MCP.
Manage 230M+ influencers, track campaigns, and access real-time CIMS analytics via AI agents
Account/OAuth MCP for cited investor research: theses, risks, catalysts, revisions and historical cutoffs. This connection requires a BeliefState account. For accountless access, use https://beliefstate.ai/v1/research/mcp with a compatible x402 Base USDC wallet: 16 paid research tools plus two free discovery tools, 0.02–1.50 USDC per paid call.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables interaction with Google Ads accounts through the Model Context Protocol, specifically tuned for local service businesses. Provides account health scoring, search term waste analysis, and diagnostic insights without requiring GAQL knowledge.11355 npm1MIT
- AlicenseNot gradedqualityDmaintenanceProvides a standardized interface for interacting with Mailchimp's tools and services through the Model Context Protocol, enabling easy management of Mailchimp campaigns, audiences, and reports via natural language commands.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables interaction with dbt projects via the Model Context Protocol for data analysis and insights.4MIT
- AlicenseDqualityFmaintenanceEnables LLMs to interact with Google Ads accounts via tools like list_accounts and search_stream, using a standardized Model Context Protocol integration.211Apache 2.0