home / mcp / metricool mcp server

Metricool MCP Server

This is a Multi-Agent Collaboration Protocol (MCP) server for interacting with the Metricool API. It allows AI agents to access and analyze social media metrics and campaign data from your Metricool account.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "metricool-mcp-metricool": {
      "command": "uvx",
      "args": [
        "--upgrade",
        "mcp-metricool"
      ],
      "env": {
        "METRICOOL_USER_ID": "<METRICOOL_USER_ID>",
        "METRICOOL_USER_TOKEN": "<METRICOOL_USER_TOKEN>"
      }
    }
  }
}

The Metricool MCP Server lets you connect to your Metricool account and access analytics, posts, campaigns, and scheduling capabilities through an MCP client. It enables AI agents to analyze metrics, pull brand data, and schedule content programmatically with a lightweight, extensible interface.

How to use

You interact with this MCP server through an MCP client. Start the server locally using the provided runtime and configuration, then request the available tools to fetch metrics, posts, campaigns, and scheduling information from your Metricool brand accounts. Use the tools to pull data for specific date ranges, compare performance across networks, analyze competitors, and schedule posts across your brands. You can combine multiple tools in a single conversation to build complex data analyses and operational workflows.

How to install

Prerequisites include Python 3.8 or higher, a Metricool account with API access (Advanced Tier), and an MCP client such as Claude Desktop. You also need uv and git installed on your system.

1) Install the required runtime tooling (uvx). 2) Prepare the MCP configuration for your client. 3) Run the MCP server and verify it starts correctly.

Step-by-step commands you can run now,

Configuration and runtime details

{
  "mcpServers": {
    "mcp-metricool": {
      "command": "uvx",
      "args": [
        "--upgrade",
        "mcp-metricool"
      ],
      "env": {
        "METRICOOL_USER_TOKEN": "<METRICOOL_USER_TOKEN>",
        "METRICOOL_USER_ID": "<METRICOOL_USER_ID>"
      }
    }
  }
}

Available tools

get_brands

Get the list of brands from your Metricool account. A simplified tool for auxiliary usage in other tools.

get_brands_complete

Get the list of brands from your Metricool account with all available information for each brand.

get_instagram_reels

Get the list of Instagram Reels from your Metricool account for a given date range and blog.

get_instagram_posts

Get the list of Instagram Posts from your Metricool account for a given date range and blog.

get_instagram_stories

Get the list of Instagram Stories from your Metricool account for a given date range and blog.

get_tiktok_videos

Get the list of TikTok Videos from your Metricool account for a given date range and blog.

get_facebook_reels

Get the list of Facebook Reels from your Metricool account for a given date range and blog.

get_facebook_posts

Get the list of Facebook Posts from your Metricool brand account for a given date range and blog.

get_facebook_stories

Get the list of Facebook Stories from your Metricool brand account for a given date range and blog.

get_thread_posts

Get the list of Threads Posts from your Metricool brand account for a given date range and blog.

get_x_posts

Get the list of X (Twitter) Posts from your Metricool account for a given date range and blog.

get_bluesky_posts

Get the list of Bluesky Posts from your Metricool brand account for a given date range and blog.

get_linkedin_posts

Get the list of Linkedin Posts from your Metricool brand account for a given date range and blog.

get_pinterest_pins

Get the list of Pinterest Pins from your Metricool brand account for a given date range and blog.

get_youtube_videos

Get the list of YouTube Videos from your Metricool brand account for a given date range and blog.

get_twitch_videos

Get the list of Twitch Videos from your Metricool account for a given date range and blog.

get_facebookads_campaigns

Get the list of Facebook Ads Campaigns from your Metricool account for a given date range and blog.

get_googleads_campaigns

Get the list of Google Ads Campaigns from your Metricool account for a given date range and blog.

get_tiktokads_campaigns

Get the list of TikTok Ads Campaigns from your Metricool brand account for a given date range and blog.

get_network_competitors

Get the list of competitors from your Metricool brand account across networks (Instagram, Facebook, X, Bluesky, YouTube and Twitch).

get_network_competitors_posts

Get and analyze the posts of competitors from your Metricool brand account across networks.

post_schedule_post

Schedule a post (or multipost) to your brands in Metricool.

get_scheduled_posts

Get the scheduled posts from your Metricool brand account.

get_best_time_to_post

Get the best time to post for a specific social network, returning preferred days and hours.

update_schedule_post

Update a scheduled post within the same conversation or a previously scheduled post.

get_metrics

Get the available metrics to obtain analysis from a specific social network.

get_analytics

Get the analytics from a specific social network of your Metricool brand account.

get_pinterest_boards

Get Pinterest Boards from a specific Metricool brand account.