Audiense Insights MCP Server
Audiense Insights MCP Server is a server based on the Model Context Protocol (MCP) that allows Claude and other MCP-compatible clients to interact with your Audiense Insights account.
MCP Info
| Attribute | Details |
|---|---|
| Docker Image | mcp/audiense-insights |
| Author | AudienseCo |
| Repository | https://github.com/AudienseCo/mcp-audiense-insights |
Image Building Info
| Attribute | Details |
|---|---|
| Dockerfile | https://github.com/AudienseCo/mcp-audiense-insights/blob/f18ffa6ddf944769f3c95944281f752bf6369fa5/Dockerfile |
| Commit | f18ffa6ddf944769f3c95944281f752bf6369fa5 |
| Docker Image built by | Docker Inc. |
| Docker Scout Health Score | Docker Scout Health Score |
| Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/audiense-insights --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| Licence | Apache License 2.0 |
Available Tools (8)
| Tools provided by this Server | Short Description |
|---|---|
compare-audience-influencers |
Compares the influencers of an audience with a baseline audience. |
get-audience-content |
Retrieves audience content engagement details for a given audience. |
get-audience-insights |
Retrieves aggregated insights for a given audience ID, providing statistical distributions across various attributes. |
get-baselines |
Retrieves available baselines, optionally filtered by country. |
get-categories |
Retrieves the list of available affinity categories that can be used as the categories parameter in the compare-audience-influencers tool. |
get-report-info |
Retrieves detailed information about a specific intelligence report, including its status, segmentation type, audience size, segments, and access links. |
get-reports |
Retrieves the list of Audiense insights reports owned by the authenticated user. |
report-summary |
Generates a comprehensive summary of an Audiense report, including segment details, top insights, and influencers. |
Tools Details
Tool: compare-audience-influencers
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.
| Parameters | Type | Description |
|---|---|---|
audience_influencers_id |
string |
The ID of the audience influencers. |
baseline_audience_influencers_id |
string |
The ID of the baseline audience influencers. |
bio_keyword |
string optional |
Keyword to filter influencers by their biography. |
categories |
array optional |
Filter influencers by categories. |
count |
number optional |
Number of items per page (default: 200). |
countries |
array optional |
Filter influencers by country ISO codes. |
cursor |
number optional |
Cursor for pagination. |
entity_type |
string optional |
Filter by entity type (person or brand). |
followers_max |
number optional |
Maximum number of followers. |
followers_min |
number optional |
Minimum number of followers. |
Tool: get-audience-content
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.
| Parameters | Type | Description |
|---|---|---|
audience_content_id |
string |
The ID of the audience content to retrieve. |
Tool: get-audience-insights
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).
| Parameters | Type | Description |
|---|---|---|
audience_insights_id |
string |
The ID of the audience insights. |
insights |
array optional |
Optional list of insight names to filter. |
Tool: get-baselines
Retrieves available baselines, optionally filtered by country.
| Parameters | Type | Description |
|---|---|---|
country |
string optional |
ISO country code to filter by. |
Tool: get-categories
Retrieves the list of available affinity categories that can be used as the categories parameter in the compare-audience-influencers tool.
Tool: get-report-info
Retrieves detailed information about a specific intelligence report, including its status, segmentation type, audience size, segments, and access links.
| Parameters | Type | Description |
|---|---|---|
report_id |
string |
The ID of the intelligence report. |
Tool: get-reports
Retrieves the list of Audiense insights reports owned by the authenticated user.
Tool: report-summary
Generates a comprehensive summary of an Audiense report, including segment details, top insights, and influencers.
| Parameters | Type | Description |
|---|---|---|
report_id |
string |
The ID of the intelligence report to summarize. |
Use this MCP Server
{
"mcpServers": {
"audiense-insights": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AUDIENSE_CLIENT_ID",
"-e",
"AUDIENSE_CLIENT_SECRET",
"-e",
"TWITTER_BEARER_TOKEN",
"mcp/audiense-insights"
],
"env": {
"AUDIENSE_CLIENT_ID": "your_client_id_here",
"AUDIENSE_CLIENT_SECRET": "your_client_secret_here",
"TWITTER_BEARER_TOKEN": "your_token_here"
}
}
}
}