Audiense Insights MCP Server

Prerequisites

• **Node.js** (v18 or higher)

• **Claude Desktop App**

• **Audiense Insights Account** with API credentials

• **X/Twitter API Bearer Token** _(optional, for enriched influencer data)_

Installing via Smithery

Configuring Claude Desktop

1. Open the configuration file for Claude Desktop: - **MacOS:** ```bash code ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` - **Windows:** ```bash code %AppData%\Claude\claude_desktop_config.json ```

2. Add or update the following configuration: ```json "mcpServers": { "audiense-insights": { "command": "/opt/homebrew/bin/node", "args": [ "/ABSOLUTE/PATH/TO/YOUR/build/index.js" ], "env": { "AUDIENSE_CLIENT_ID": "your_client_id_here", "AUDIENSE_CLIENT_SECRET": "your_client_secret_here", "TWITTER_BEARER_TOKEN": "your_token_here" } } }

3. Save the file and restart Claude Desktop.

Available Tools

`get-reports`

• **Parameters**: _None_

• **Response**: - List of reports in JSON format.

`get-report-info`

• 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`

• **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`

• **Parameters**: - `country` _(string, optional)_: ISO country code to filter by.

• **Response**: - List of baseline audiences in JSON format.

`get-categories`

• **Parameters**: _None_

• **Response**: - List of categories in JSON format.

`compare-audience-influencers`

• 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.

• **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`

• **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.

• `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`

• 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

• `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.

• Accepts a reportName argument to find the most relevant report.

• If an ID is provided, it searches by report ID instead.

Troubleshooting

Tools Not Appearing in Claude

1. Check Claude Desktop logs:

1. Verify environment variables are set correctly.

2. 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

For MacOS/Linux:

For Windows:

Security Considerations

• Keep API credentials secure never expose them in public repositories.

• Use environment variables to manage sensitive data.

License