Access Social Media Data and Schedule Posts
Metricool MCP Server pulls social media posts and metrics across 10+ platforms and lets you schedule content.
1.0.0Add to Favorites
Why it matters
Connect to the Metricool API to retrieve comprehensive social media metrics, campaign data, and schedule posts across numerous platforms. Automate your social media management and gain insights into performance.
Outcomes
What it gets done
Retrieve Instagram Reels, posts, and stories.
Fetch TikTok and Facebook Reels, posts, and stories.
Access data for X (Twitter), LinkedIn, YouTube, Pinterest, Threads, and Bluesky.
Schedule posts and analyze campaign performance.
Source
Get it from source
Spark does not host a copy of it.
Open sourceReports
Agent outcome reports
No reports yet
Capabilities
Tools your agent gets
Get a list of brands from your Metricool account.
Get a list of brands from your Metricool account with all available information.
Get a list of Instagram Reels from your Metricool account.
Get a list of Instagram posts from your Metricool account.
Get a list of Instagram stories from your Metricool account.
Get a list of TikTok videos from your Metricool account.
Get a list of Facebook Reels from your Metricool account.
Get a list of Facebook posts from your Metricool brand account.
Overview
Metricool MCP Server
Metricool MCP Server gives an AI assistant access to social media metrics, content, and scheduling across Instagram, TikTok, Facebook, X, LinkedIn, and more via Metricool's API. Use it when an AI assistant needs to pull social media metrics, campaign data, or schedule posts across multiple platforms.
What it does
Metricool MCP Server connects an AI assistant to the Metricool API, letting it retrieve social media metrics and content, pull campaign data, and schedule posts across multiple social platforms from one place instead of switching between each network's own dashboard.
When to use - and when NOT to
Use it when you want an AI assistant to pull post history and performance data from your connected social accounts, retrieve ad campaign data from Facebook Ads, Google Ads, or TikTok Ads, schedule posts and multiposts, analyze competitor content, or check optimal posting times for a network. It requires a Metricool account with API access, specifically the Advanced plan, plus your METRICOOL_USER_TOKEN and METRICOOL_USER_ID, so it is not usable on Metricool's free tier without API access. It is scoped to accounts you already manage in Metricool, not a general social-listening tool for arbitrary public accounts.
Capabilities
Brand tools, get_brands and get_brands_complete, list the brands in your Metricool account: get_brands is a simplified lookup meant for auxiliary use inside other tool calls, while get_brands_complete returns all available information for each brand. Platform content tools retrieve posts, reels, or stories per network: get_instagram_reels, get_instagram_posts, and get_instagram_stories for Instagram; get_tiktok_videos for TikTok; get_facebook_reels, get_facebook_posts, and get_facebook_stories for Facebook; get_thread_posts for Threads; get_x_posts for X (Twitter); get_bluesky_posts for Bluesky; get_linkedin_posts for LinkedIn; get_pinterest_pins for Pinterest; and get_youtube_videos for YouTube. Beyond content retrieval, the server also covers ad campaign data from Facebook Ads, Google Ads, and TikTok Ads, post and multipost scheduling, competitor post analysis, optimal-posting-time recommendations, and management of scheduled posts and content calendars, with coverage extending to Twitch as well.
How to install
Install and run via uvx:
uvx --upgrade mcp-metricool
Configure Claude Desktop with your Metricool credentials:
{
"mcpServers": {
"mcp-metricool": {
"command": "uvx",
"args": ["--upgrade", "mcp-metricool"],
"env": {
"METRICOOL_USER_TOKEN": "<METRICOOL_USER_TOKEN>",
"METRICOOL_USER_ID": "<METRICOOL_USER_ID>"
}
}
}
}
Requires Python 3.8+ along with uv and git. The Claude Desktop configuration file lives in a different place depending on your OS: ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%/Claude/claude_desktop_config.json on Windows.
Who it's for
Social media managers and marketers who want an AI assistant to pull cross-platform metrics, review campaign performance, and schedule posts from Metricool, instead of checking each social network's dashboard separately. Published directly by Metricool, the server requires both METRICOOL_USER_TOKEN and METRICOOL_USER_ID to be set as environment variables before any tool call will authenticate successfully.
Source README
MCP server for working with Metricool API, enabling retrieval of social media metrics, campaign data, and scheduling posts across multiple social platforms.
Installation
uvx
uvx --upgrade mcp-metricool
Configuration
Claude Desktop
{
"mcpServers": {
"mcp-metricool": {
"command": "uvx",
"args": [
"--upgrade",
"mcp-metricool"
],
"env": {
"METRICOOL_USER_TOKEN": "<METRICOOL_USER_TOKEN>",
"METRICOOL_USER_ID": "<METRICOOL_USER_ID>"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
get_brands |
Get a list of brands from your Metricool account. Simplified tool for auxiliary use in other tools... |
get_brands_complete |
Get a list of brands from your Metricool account with all available information for each brand... |
get_instagram_reels |
Get a list of Instagram Reels from your Metricool account. |
get_instagram_posts |
Get a list of Instagram posts from your Metricool account. |
get_instagram_stories |
Get a list of Instagram stories from your Metricool account. |
get_tiktok_videos |
Get a list of TikTok videos from your Metricool account. |
get_facebook_reels |
Get a list of Facebook Reels from your Metricool account. |
get_facebook_posts |
Get a list of Facebook posts from your Metricool brand account. |
get_facebook_stories |
Get a list of Facebook stories from your Metricool brand account. |
get_thread_posts |
Get a list of Threads posts from your Metricool brand account. |
get_x_posts |
Get a list of X (Twitter) posts from your Metricool account. |
get_bluesky_posts |
Get a list of Bluesky posts from your Metricool brand account. |
get_linkedin_posts |
Get a list of LinkedIn posts from your Metricool brand account. |
get_pinterest_pins |
Get a list of Pinterest pins from your Metricool brand account. |
get_youtube_videos |
Get a list of YouTube videos from your Metricool brand account. |
Capabilities
- Access and analyze social media metrics across multiple platforms
- Retrieve campaign data from Facebook Ads, Google Ads, and TikTok Ads
- Schedule posts and multiposts for your brands
- Analyze competitor posts and their performance
- Get optimal posting times for different social networks
- Access content from Instagram, Facebook, TikTok, Twitter/X, LinkedIn, YouTube, Pinterest, Twitch, Threads, and Bluesky
- Manage scheduled posts and content calendars
Environment Variables
Required
METRICOOL_USER_TOKEN- Your Metricool API tokenMETRICOOL_USER_ID- Your Metricool user ID
Notes
Requires a Metricool account with API access (Advanced plan). Python 3.8 or higher is required along with uv and git. Configuration file location depends on your OS: macOS uses ~/Library/Application Support/Claude/claude_desktop_config.json, Windows uses %APPDATA%/Claude/claude_desktop_config.json.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.