Metricool MCP Server

What does “Metricool” MCP Server do?

The Metricool MCP Server is a Model Context Protocol (MCP) server designed to interface with the Metricool API, enabling AI agents to access, retrieve, and analyze social media metrics and campaign data from a user’s Metricool account. By acting as a bridge between AI assistants and the Metricool platform, this server empowers developers and agents to automate the extraction of actionable insights, manage and schedule social media posts, and monitor advertising performance across multiple networks. Its suite of tools supports tasks such as fetching analytics for posts and campaigns, scheduling content, and benchmarking against competitors, facilitating more efficient and data-driven workflows for social media managers, marketers, and developers.

List of Prompts

No information about prompt templates was found in the repository.

List of Resources

No explicit MCP resources are documented in the repository.

List of Tools

• get_brands(state: str)
  Retrieves the list of brands associated with your Metricool account.

• get_instagram_reels(init_date: str, end_date: str, blog_id: int)
  Fetches Instagram Reels data for a given brand and date range.

• get_instagram_posts(init_date: str, end_date: str, blog_id: int)
  Fetches Instagram Posts data for a specified brand and date range.

• get_instagram_stories(init_date: str, end_date: str, blog_id: int)
  Retrieves Instagram Stories within a date range for a specific brand.

• get_tiktok_videos(init_date: str, end_date: str, blog_id: int)
  Retrieves TikTok videos for the selected brand and period.

• get_facebook_reels(init_date: str, end_date: str, blog_id: int)
  Gets Facebook Reels from a Metricool brand account.

• get_facebook_posts(init_date: str, end_date: str, blog_id: int)
  Obtains Facebook Posts for a particular brand account and date range.

• get_facebook_stories(init_date: str, end_date: str, blog_id: int)
  Retrieves Facebook Stories from a brand account.

• get_thread_posts(init_date: str, end_date: str, blog_id: int)
  Fetches Threads Posts from the brand account.

• get_x_posts(init_date: str, end_date: str, blog_id: int)
  Retrieves X (Twitter) posts for a brand and time range.

• get_bluesky_posts(init_date: str, end_date: str, blog_id: int)
  Fetches Bluesky posts for the brand.

• get_linkedin_posts(init_date: str, end_date: str, blog_id: int)
  Retrieves LinkedIn posts from the brand account.

• get_pinterest_pins(init_date: str, end_date: str, blog_id: int)
  Fetches Pinterest Pins for a brand.

• get_youtube_videos(init_date: str, end_date: str, blog_id: int)
  Gets YouTube videos published by the brand.

• get_twitch_videos(init_date: str, end_date: str, blog_id: int)
  Retrieves Twitch videos from the brand account.

• get_facebookads_campaigns(init_date: str, end_date: str, blog_id: int)
  Retrieves Facebook Ads Campaigns data.

• get_googleads_campaigns(init_date: str, end_date: str, blog_id: int)
  Fetches Google Ads Campaigns for the brand.

• get_tiktokads_campaigns(init_date: str, end_date: str, blog_id: int)
  Retrieves TikTok Ads Campaigns from the brand account.

• get_network_competitors
  Gets the list of competitors (across Instagram, Facebook, X, Bluesky, YouTube, and Twitch).

• post_schedule_post
  Schedules one or more posts for the brand(s) in Metricool.

• get_scheduled_posts
  Retrieves scheduled posts from the Metricool account.

• get_best_time_to_post
  Determines the best time to publish social media content.

Use Cases of this MCP Server

• Social Media Analytics Automation
  Developers can automate the retrieval and analysis of metrics across platforms (Instagram, Facebook, X, etc.), enabling real-time dashboards and custom reporting for social teams.

• Content Scheduling
  AI agents can schedule posts or multiposts for various brands, improving workflow efficiency and ensuring timely publication without manual intervention.

• Competitor Benchmarking
  By accessing competitor data, developers and marketers can compare performance across networks and adjust strategies accordingly.

• Ad Campaign Monitoring
  Pulling metrics from Facebook, Google, and TikTok ad campaigns enables performance tracking, budget optimization, and ROI analysis within custom apps or dashboards.

• Optimal Posting Time Discovery
  Using analytics to determine the best time to post on specific channels, AI agents can advise or automate optimal scheduling for higher engagement.

How to set it up

Windsurf

No instructions found for Windsurf.

Claude

1. Ensure Python 3.8+ and uv are installed.
2. Obtain your Metricool API token and user ID (Advanced Tier required).
3. Locate or create the configuration file:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
4. Add the Metricool MCP server configuration:

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

5. Save the file and restart Claude Desktop.
6. Verify setup by attempting to access Metricool data from within Claude.

Securing API Keys

API keys are set via environment variables in the "env" section as shown above, ensuring sensitive information is not hardcoded.

Cursor

No instructions found for Cursor.

Cline

No instructions found for Cline.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "mcp-metricool": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change "mcp-metricool" to your actual server name and update the URL accordingly.

Overview

Our opinion

Metricool MCP offers a robust set of tools for social media analytics and management, with clear setup instructions for Claude Desktop and strong utility for marketers and developers. However, the absence of documented prompt templates, resources, and broader client setup instructions (for Windsurf, Cursor, etc.) limits its out-of-the-box versatility. Sampling and Roots support are not mentioned.

Rating: 6/10

MCP Score