Social Analytics MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Set to 'social-analytics-mcp' for debug logs | |
| FACEBOOK_PAGE_ID | No | Facebook Page ID (use discovery tool if not provided) | |
| FACEBOOK_API_VERSION | No | Facebook Graph API version | v22.0 |
| INSTAGRAM_ACCOUNT_ID | No | Instagram Business Account ID (auto-detected if not provided) | |
| FACEBOOK_ACCESS_TOKEN | No | Facebook User/Page Access Token | |
| INSTAGRAM_API_VERSION | No | Instagram Graph API version | v23.0 |
| INSTAGRAM_ACCESS_TOKEN | No | Facebook User Access Token with Instagram permissions |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| instagram_list_accountsA | List all available Instagram Business accounts. Use this first to discover account IDs. |
| instagram_get_profileA | Get Instagram business account profile information (username, followers, media count, etc.). If account_id is not provided, it will be auto-detected from the environment or discovered automatically. |
| instagram_get_account_insightsA | Get account-level insights and analytics for Instagram. Supports demographic breakdowns and time series data. |
| instagram_list_mediaB | Get a list of recent media posts from Instagram account. Returns posts with basic engagement data. |
| instagram_get_media_detailsA | Get detailed information about a specific Instagram media post including caption, type, URL, and engagement counts. |
| instagram_get_media_insightsA | Get insights for a specific Instagram media post. Note: Available metrics depend on media type. For Reels/Videos: use views, likes, comments, shares, reach, saved, total_interactions, replies, avg_time_watched, total_time_watched. For Images/Carousels: use likes, comments, reach, saved, shares, total_interactions. Story-specific metrics (replies, navigation) only work on story media. |
| instagram_get_storiesA | Get recent Instagram Stories for the account. Stories are only available for 24 hours after posting. Returns story media items with basic fields. |
| instagram_get_hashtag_searchA | Search for an Instagram hashtag ID by name. The returned ID can be used with instagram_get_hashtag_media to fetch top/recent media. Limited to 30 unique hashtag searches per 7-day rolling window per account. |
| instagram_get_hashtag_mediaA | Get top or recent media for a hashtag. Use instagram_get_hashtag_search first to get the hashtag ID. |
| instagram_get_content_publishing_limitA | Check the content publishing rate limit status for the Instagram account. Shows current quota usage and limits. |
| instagram_get_mentioned_mediaA | Get media where the Instagram account is mentioned or tagged by other users. |
| facebook_list_pagesA | List all Facebook Pages accessible with the current access token. Use this first to discover page IDs. |
| facebook_get_page_detailsA | Get detailed information about a Facebook Page including name, category, follower count, about section, contact info, and more. |
| facebook_get_page_insightsB | Fetch page-level insights for a Facebook Page. Common metrics: page_impressions, page_impressions_unique, page_engaged_users, page_post_engagements, page_views_total, page_fans. |
| facebook_get_post_insightsB | Fetch insights for a specific Facebook Page post. Common metrics: post_impressions, post_impressions_unique, post_engaged_users. |
| facebook_list_posts_with_insightsA | List Facebook Page posts including inline insight metrics. Combines post data with metrics in a single request. |
| facebook_get_page_feedA | Get the Facebook Page feed with full post details including reactions, comments, and shares counts. |
| facebook_list_known_metricsA | List all known/supported Facebook Page and Post metrics with their valid periods. Useful for discovering what metrics are available. |
| facebook_validate_tokenA | Validate a Facebook access token by checking it against the /me endpoint. Returns token validity, user ID, and name. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_instagram_performance | Analyze Instagram account performance with key metrics and insights |
| analyze_facebook_performance | Analyze Facebook Page performance with key metrics and insights |
| compare_post_performance | Compare performance of recent posts on Instagram or Facebook |
| get_audience_demographics | Get detailed audience demographics for Instagram or Facebook |
| setup_platform | Guide user through setting up Instagram or Facebook analytics |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Most tools are clearly distinct by platform and resource type, but a few pairs like facebook_list_posts_with_insights and facebook_get_page_feed could be confused since both list posts with engagement data. Descriptions help differentiate by emphasizing inline insights vs. full post details.
Tools follow a consistent platform_verb_noun pattern using snake_case, with 'list' for collections and 'get' for individual items. Minor deviations like 'list_posts_with_insights' and 'validate_token' break the simple pattern but remain readable and predictable.
With 19 tools covering two distinct platforms (Instagram and Facebook) and multiple analytics levels, the count is slightly heavy but justifiable. Each tool serves a specific purpose, and the two-platform scope naturally expands the surface area.
The server covers the core analytics lifecycle: account/page discovery, profile details, insights at account/page/post/media levels, media/posts listing, stories, hashtags, publishing limits, and token validation. Minor gaps exist, such as no dedicated Facebook post detail-by-ID tool, but list endpoints provide the necessary IDs.