Metricool MCP

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'metricoolmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Metricool MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'metricoolmcp_getanalyticsavailablemetrics',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "metricoolmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Metricool MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="metricoolmcp_getanalyticsavailablemetrics",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Sendscheduledpostforreview records — Send an already-scheduled post to review (approval flow) in Metricool
• Createscheduledpostforreview records — Schedule a new post and send it to review (approval flow) in Metricool, replicating the web “Send for review” action
• Updatescheduledpost records — Update a scheduled post in Metricool
• Getscheduledposts records — Get the list of scheduled posts for a specific Metricool brand
• Getbrandsettings records — Get the list of brands from your Metricool account
• Getbesttimetopostbynetwork records — Get the best time to post for a specific social network on a Metricool account

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

metricoolmcp_createscheduledpost#Schedule a post to Metricool at a specific date and time across one or more social networks.4 params▾

Schedule a post to Metricool at a specific date and time across one or more social networks.

NameTypeRequiredDescription

blogIdstringrequiredBlog id of the Metricool brand account

datestringrequiredPublication date/time. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS±HH:MM)

infostringrequiredJSON-encoded post data including providers, text, publicationDate, media, networkData, etc.

mediaFilesarrayoptionalFiles from ChatGPT file picker. Each item has download_url (required), file_id (required), mime_type, file_name.

metricoolmcp_createscheduledpostforreview#Schedule a new post and send it to review (approval flow) in Metricool, replicating the web "Send for review" action.6 params▾

Schedule a new post and send it to review (approval flow) in Metricool, replicating the web "Send for review" action.

NameTypeRequiredDescription

approvalSystemstringrequiredApproval system: any, all or optional

blogIdstringrequiredBlog id of the Metricool brand account

datestringrequiredPublication date/time once approved. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS±HH:MM)

infostringrequiredData of the post to be scheduled. Same JSON structure as createScheduledPost.

reviewersstringrequiredComma-separated list of reviewer emails

notifybooleanoptionalNotify internal Metricool reviewers by email. Default true. External reviewers are always emailed.

metricoolmcp_getanalyticsavailablemetrics#Get the available analytics metrics for a specific social network and connector in Metricool.2 params▾

Get the available analytics metrics for a specific social network and connector in Metricool.

NameTypeRequiredDescription

connectorstringoptionalConnector type (e.g. evolution, posts, reels, stories, competitors, hashtags, campaigns, videos)

networkstringoptionalSocial network (e.g. instagram, facebook, twitter, youtube, tiktok, linkedin, pinterest, twitch, bluesky, threads, googleBusinessProfile, metaAds, facebookAds, tiktokAds, brandInfo, website, brandSummary)

metricoolmcp_getanalyticsdatabymetrics#Retrieve analytical data for a Metricool account over a date range based on selected metrics.4 params▾

Retrieve analytical data for a Metricool account over a date range based on selected metrics.

NameTypeRequiredDescription

brandIdstringrequiredBrand id of the Metricool account

fromstringrequiredStart date. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS±HH:MM)

tostringrequiredEnd date. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS±HH:MM)

metricsarrayoptionalList of Data Studio field IDs (e.g. IGPO01)

metricoolmcp_getbesttimetopostbynetwork#Get the best time to post for a specific social network on a Metricool account.5 params▾

Get the best time to post for a specific social network on a Metricool account.

NameTypeRequiredDescription

brandIdstringrequiredBlog id of the Metricool brand account

fromDatestringrequiredStart date. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS±HH:MM)

socialNetworkstringrequiredSocial network: twitter, facebook, instagram, linkedin, youtube, or tiktok

timezonestringrequiredTimezone. Format: IANA identifier

toDatestringrequiredEnd date. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS±HH:MM)

metricoolmcp_getbrandsettings#Get the list of brands from your Metricool account. Only Instagram, Facebook, Twitch, YouTube, Twitter, and Bluesky support competitors.0 params▾

Get the list of brands from your Metricool account. Only Instagram, Facebook, Twitch, YouTube, Twitter, and Bluesky support competitors.

metricoolmcp_getscheduledposts#Get the list of scheduled posts for a specific Metricool brand.5 params▾

Get the list of scheduled posts for a specific Metricool brand.

NameTypeRequiredDescription

brandIdstringrequiredBlog id of the Metricool brand account

fromDatestringrequiredStart date. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS±HH:MM)

timezonestringrequiredTimezone of the post. Format: IANA identifier

toDatestringrequiredEnd date. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS±HH:MM)

extendedRangebooleanoptionalWhen true, search date range is expanded one day before and after. Default: false

metricoolmcp_sendscheduledpostforreview#Send an already-scheduled post to review (approval flow) in Metricool. Requires the post id and uuid from getScheduledPosts.7 params▾

Send an already-scheduled post to review (approval flow) in Metricool. Requires the post id and uuid from getScheduledPosts.

NameTypeRequiredDescription

approvalSystemstringrequiredApproval system: any, all or optional

blogIdstringrequiredBlog id of the Metricool brand account

idstringrequiredId of the already scheduled post

infostringrequiredFull content of the post to send to review, same JSON structure as updateScheduledPost

reviewersstringrequiredComma-separated list of reviewer emails

uuidstringrequiredUuid of the already scheduled post

notifybooleanoptionalNotify internal Metricool reviewers by email. Default true. External reviewers are always emailed.

metricoolmcp_updatescheduledpost#Update a scheduled post in Metricool. Requires the post id and uuid from getScheduledPosts.5 params▾

Update a scheduled post in Metricool. Requires the post id and uuid from getScheduledPosts.

NameTypeRequiredDescription

blogIdstringrequiredBlog id of the Metricool brand account

idstringrequiredId of the post to update

infostringrequiredJSON-encoded post data with full original content plus modifications

uuidstringrequiredUuid of the post to update

mediaFilesarrayoptionalFiles from ChatGPT file picker. Each item has download_url (required), file_id (required), mime_type, file_name.