First-party app
Metricool Metricool

Metricool

Manage Metricool brands, schedule and edit social posts, and read analytics and competitor data.

stable Social MediaMarketing

About

Metricool ships in the w6w first-party pack. It declares 18 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.metricool
Version
0.1.1
Author
w6w
Licence
MIT
Categories
Social Media · Marketing

Overview

Metricool is a social media management platform: one place to plan and publish posts across networks and to read how each brand’s accounts perform.

This app lists your brands, then schedules, updates, reschedules, reads and deletes a brand’s scheduled posts; reads a brand’s metrics as a time series, a single total or a distribution for networks such as Instagram, Facebook, TikTok, YouTube, LinkedIn, X, Pinterest, Twitch and Google Business Profile; lists published posts with their metrics and popular hashtags; and tracks competitors.

A connection holds your Metricool user token and user id. Each brand-scoped action takes the brand’s blogId, which List Brands returns. API access requires a Metricool plan that includes it.

Build with Metricool

Three routes to the same 18 actions. The Workflow tab is generated from Metricool's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Get Metric Total

analytics-aggregation

A single aggregated value of a metric for a brand on one network over a period.

Get Metric Distribution

analytics-distribution

A metric's breakdown (key/value pairs) for a brand on one network over a period.

Get Metric Timeline

analytics-timeline

A metric's time series for a brand on one network over a period.

Get Brand

brand-get

Get one brand's settings: title, timezone, connected networks and role.

List Brands

brand-list

List the brands (profiles) of the connected Metricool account. Each brand's `id` is the blogId the other actions take.

List Published Posts With Metrics

brand-summary-posts-list

A brand's published posts across all its networks in a period, each with metrics.

Add Competitor

competitor-add

Start tracking a competitor account on a network.

Get Competitor Metric Total

competitor-aggregation

A competitor's single aggregated metric value over a period.

List Competitors

competitor-list

A brand's competitors on one network, with follower and engagement figures.

Remove Competitor

competitor-remove

Stop tracking a competitor on a network.

Get Competitor Timeline

competitor-timeline

A competitor's metric time series over a period.

Search Popular Hashtags

hashtag-search

Popular hashtags, optionally for one network and matching a search term.

Create Scheduled Post

post-create

Schedule a post to one or more of a brand's networks.

Delete Scheduled Post

post-delete

Delete a scheduled post. Deleting a thread's parent post deletes the whole thread.

Get Scheduled Post

post-get

Get one scheduled post by id, with its per-network publishing status.

List Scheduled Posts

post-list

List a brand's scheduled posts between two dates.

Reschedule Post

post-reschedule

Change only a scheduled post's publication date. For a thread's parent post the whole thread moves.

Update Scheduled Post

post-update

Replace a scheduled post (PUT): fields you omit are not carried over, so send the whole post. To only move the publication date use Reschedule Post.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Metricool's real ids.

{
  "manifestVersion": "2",
  "name": "metricool-example",
  "steps": [
    {
      "id": "analytics-aggregation",
      "uses": {
        "app": "io.w6w.metricool",
        "action": "analytics-aggregation",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "blogId": "<blogId>",
        "network": "<network>",
        "metric": "<metric>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Metric Total

    read
    analytics-aggregation
  • Get Metric Distribution

    read
    analytics-distribution
  • Get Metric Timeline

    read
    analytics-timeline
  • Get Brand

    read
    brand-get
  • List Brands

    read
    brand-list

+13 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Metricool, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Metricool. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "analytics-aggregation",
  payload: {
    blogId: "<value>",
    network: "<value>",
    metric: "<value>",
    from: "<value>",
    to: "<value>",
    // timezone: "<value>",
    // subject: "<value>",
    // scope: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action analytics-aggregation --payload '{"blogId":"<value>","network":"<value>","metric":"<value>","from":"<value>","to":"<value>"}'

Give an AI agent Metricool — without giving it Metricool's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.metricool#analytics-aggregation",
    "input": {
      "blogId": "<blogId>",
      "network": "<network>",
      "metric": "<metric>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Metricool connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Metricool's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Metricool itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Metricool declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Metricool platform status

dependency

API reachable

Unsigned GET https://app.metricool.com/api/v2/health; passes only on the documented {"status":"UP"} body.

quota

API request headroom