MCP Connector

Access Social Media Data and Schedule Posts

Metricool MCP Server pulls social media posts and metrics across 10+ platforms and lets you schedule content.

Works with metricoolinstagramtiktokfacebookthreads

90
Spark score
out of 100
Updated 7 months ago
Source checked Sep 10, 2026
Version 1.0.0
Models
universal

Add 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

01

Retrieve Instagram Reels, posts, and stories.

02

Fetch TikTok and Facebook Reels, posts, and stories.

03

Access data for X (Twitter), LinkedIn, YouTube, Pinterest, Threads, and Bluesky.

04

Schedule posts and analyze campaign performance.

Source

Get it from source

Spark does not host a copy of it.

Open source

Reports

Agent outcome reports

No reports yet

Capabilities

Tools your agent gets

get_brands

Get a list of brands from your Metricool account.

get_brands_complete

Get a list of brands from your Metricool account with all available information.

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.

+7 tools

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