Metricool MCP

What is mcp-metricool?

mcp-metricool is a Model Context Protocol (MCP) server designed to interact with the Metricool API. It allows AI agents to retrieve and analyze social media metrics and campaign data, as well as schedule posts directly from your Metricool account. This facilitates automated social media management and data analysis.

How to use mcp-metricool?

To use mcp-metricool, you need to set up the MCP environment. This involves having Python 3.8+, a Metricool account with API access (Advanced Tier), an MCP Client (like Claude Desktop or Cursor), uv, and git. You then configure your MCP client by adding a JSON template with your Metricool user token and ID. Once configured, AI agents can utilize the implemented tools to interact with the Metricool API.

Key Features of mcp-metricool

• Social Media Data Retrieval: Access data for Instagram (Reels, Posts, Stories), TikTok (Videos), Facebook (Reels, Posts, Stories), Threads, X (Twitter), Bluesky, LinkedIn, Pinterest (Pins), YouTube (Videos), and Twitch (Videos).
• Ad Campaign Data Retrieval: Get data for Facebook Ads, Google Ads, and TikTok Ads campaigns.
• Competitor Analysis: Retrieve and analyze posts from competitors across various social networks.
• Post Scheduling: Schedule single or multiple posts to your brands in Metricool.
• Scheduled Post Management: View and update previously scheduled posts.
• Optimal Posting Time: Identify the best times to post on specific social networks.
• Metric and Analytics Access: Obtain available metrics and detailed analytics from specific social networks.
• Multi-Agent Collaboration: Designed for AI agents to collaborate and automate social media tasks.

Use Cases of mcp-metricool

• Automated Social Media Reporting: AI agents can automatically pull social media performance data for reporting.
• Content Scheduling Automation: Automate the scheduling of social media posts across multiple platforms.
• Competitor Monitoring: Continuously monitor competitor activity and analyze their content strategy.
• Performance Optimization: Utilize the "best time to post" feature to optimize content delivery for maximum engagement.
• Integrated Marketing Campaigns: Manage and analyze data from various ad campaigns (Facebook Ads, Google Ads, TikTok Ads) in one place.

FAQ from mcp-metricool

• What are the prerequisites for setting up mcp-metricool? You need Python 3.8 or higher, a Metricool account with Advanced Tier API access, an MCP Client (e.g., Claude Desktop), uv, and git.
• How do I configure mcp-metricool with my Metricool account? You need to create a claude_desktop_config.json file (or similar for other MCP clients) and add your Metricool user token and ID to the env section within the mcpServers configuration.
• Can I schedule posts for multiple social media platforms? Yes, the post_schedule_post tool allows you to schedule posts to your brands in Metricool, which can then be distributed across various social networks.
• Does it support competitor analysis for all social media platforms? It supports competitor analysis for Instagram, Facebook, X, Bluesky, YouTube, and Twitch.
• What kind of analytics can I get from mcp-metricool? You can get detailed analytics from specific social networks of your Metricool brand account, including metrics related to posts, reels, stories, and videos, as well as ad campaign performance.

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": [
                "--upgrade",
                "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()

   • Get the list of brands from your Metricool account. Simplified tool for auxiliar usage in other tools.

2. get_brands_complete()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

20. get_network_competitors

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

21. get_network_competitors_posts

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

22. post_schedule_post

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

23. get_scheduled_posts

    • Get the scheduled posts from your Metricool brand account.

24. 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

25. update_schedule_post

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

26. get_metrics

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

27. get_analytics

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