What is Mcp Metricool

mcp-metricool is a Multi-Agent Collaboration Protocol (MCP) server designed for interacting with the Metricool API. It enables AI agents to access, analyze social media metrics, campaign data, and schedule posts from a Metricool account.

Use cases

Use cases for mcp-metricool include automating social media reporting, analyzing the performance of social media campaigns, scheduling posts for optimal engagement, and managing multiple brands’ social media metrics in one place.

How to use

To use mcp-metricool, set up the server by ensuring you have Python 3.8 or higher, a Metricool account with API access, and the necessary configuration files. Follow the setup instructions in the README to configure Claude Desktop and replace the placeholders with your Metricool API token and user ID.

Key features

Key features of mcp-metricool include the ability to retrieve brands, Instagram Reels, posts, and stories from your Metricool account. It also allows scheduling of posts and provides tools for comprehensive social media analysis.

Where to use

mcp-metricool can be used in digital marketing, social media management, and data analysis fields, particularly for businesses and agencies that utilize Metricool for their social media strategies.

Metricool MCP Server

This is a Model Context Protocol (MCP) server for interacting with the Metricool API. It allows AI agents to access and analyze social media metrics, campaign data and schedule posts to your Metricool account.

Setup

Prerequisites

MCP is still very new and evolving, we recommend following the MCP documentation to get the MCP basics up and running.

• Python 3.8 or higher
• A Metricool account with API access (Advanced Tier)
• Claude Desktop (or Cursor, or any MCP Client)
• uv
• git

Configuration

1. Configure Claude Desktop
   Create the following file depending on your OS:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

Paste this template in the file and replace <METRICOOL_USER_TOKEN> and <METRICOOL_USER_ID> with your Metricool API and ID information:

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

Tools

The server implements several tools to interact with the Metricool API:

1. get_brands(state: str)

   • Get the list of brands from your Metricool account.

2. get_instagram_reels(init_date: str, end_date: str, blog_id: int)

   • Get the list of Instagram Reels from your Metricool account.

3. get_instagram_posts(init_date: str, end_date: str, blog_id: int)

   • Get the list of Instagram Posts from your Metricool account.

4. get_instagram_stories(init_date: str, end_date: str, blog_id: int)

   • Get the list of Instagram Stories from your Metricool account.

5. get_tiktok_videos(init_date: str, end_date: str, blog_id: int)

   • Get the list of Tiktok Videos from your Metricool account.

6. get_facebook_reels(init_date: str, end_date: str, blog_id: int)

   • Get the list of Facebook Reels from your Metricool account.

7. get_facebook_posts(init_date: str, end_date: str, blog_id: int)

   • Get the list of Facebook Posts from your Metricool brand account.

8. get_facebook_stories(init_date: str, end_date: str, blog_id: int)

   • Get the list of Facebook Stories from your Metricool brand account.

9. get_thread_posts(init_date: str, end_date: str, blog_id: int)

   • Get the list of Threads Posts from your Metricool brand account.

10. get_x_posts(init_date: str, end_date: str, blog_id: int)

    • Get the list of X (Twitter) Posts from your Metricool account.

11. get_bluesky_posts(init_date: str, end_date: str, blog_id: int)

    • Get the list of Bluesky Posts from your Metricool brand account.

12. get_linkedin_posts(init_date: str, end_date: str, blog_id: int)

    • Get the list of Linkedin Posts from your Metricool brand account.

13. get_pinterest_pins(init_date: str, end_date: str, blog_id: int)

    • Get the list of Pinterest Pins from your Metricool brand account.

14. get_youtube_videos(init_date: str, end_date: str, blog_id: int)

    • Get the list of Youtube Videos from your Metricool brand account.

15. get_twitch_videos(init_date: str, end_date: str, blog_id: int)

    • Get the list of Twitch Videos from your Metricool account.

16. get_facebookads_campaigns(init_date: str, end_date: str, blog_id: int)

    • Get the list of Facebook Ads Campaigns from your Metricool account.

17. get_googleads_campaigns(init_date: str, end_date: str, blog_id: int)

    • Get the list of Google Ads Campaigns from your Metricool account.

18. get_tiktokads_campaigns(init_date: str, end_date: str, blog_id: int)

    • Get the list of Tiktok Ads Campaigns from your Metricool brand account.

19. get_network_competitors

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

20. post_schedule_post

    • Schedule a post (o multipost) to your brands in Metricool

21. get_scheduled_posts

    • Get the scheduled posts from your Metricool brand account.

22. get_best_time_to_post

    • Get the best time to post for a specific social network. Return days and hours with the value. Higher value better hour/day to post

23. update_schedule_post

    • Update the scheduled post in the same conversation or a previously scheduled post.

24. get_metrics

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

25. get_analytics

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