How to Use the Metricool MCP in Mastra AI

Q: How do I register Metricool tools in a Mastra AI agent?

Initialize the MCP client with your Vinkius URL and call listTools(). You can then spread these tools directly into your Mastra AI agent definition, giving it immediate access to getinstagramanalytics.

Q: Does the Mastra AI integration support multi-profile setups?

Yes, it does. Your MCP agent can use listmetricoolprofiles to map out all connected accounts and then run separate workflow branches for each profile.

Build resilient, multi-step social automation workflows with Mastra AI and live Metricool data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Metricool MCP to Mastra AI

Create your Vinkius account to connect Metricool to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Metricool with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build self-healing social posting pipelines

Social APIs are notoriously flaky, but Mastra AI handles them gracefully. When your agent schedules a post using `get_social_planner`, Mastra's built-in retry engine automatically handles transient network hiccups with exponential backoff. If a queue check fails, the workflow doesn't crash. It retries behind the scenes, ensuring your automated queues stay populated without manual intervention.

Conditional branching for complex social reporting

You can set up workflows in Mastra AI that branch based on real-time social performance. For example, have your agent run `get_unified_summary` to check weekly engagement levels. If the engagement drops below your target threshold, the workflow triggers a branch that calls `get_ads_performance` to analyze paid campaigns. This lets you build smart systems that react to raw numbers without writing endless nested if-else statements.

Deploy autonomous social supervisors with this MCP Server

Use Mastra's workflow engine to keep an eye on your active accounts. Your agent can run `list_published_posts` on a cron schedule to verify what actually went live across your networks. If the system detects a mismatch between your planned calendar and published posts, it routes the discrepancy to a human reviewer. This keeps your publishing pipeline verified without requiring constant manual monitoring.

Setup guide

Set up Metricool MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Metricool tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "metricool-mcp-client",
  servers: {
    "metricool-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Metricool Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Metricool tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Metricool transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Metricool. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Metricool now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Metricool MCP in Mastra AI

Initialize the MCP client with your Vinkius URL and call `listTools()`. You can then spread these tools directly into your Mastra AI agent definition, giving it immediate access to `get_instagram_analytics`.

Yes, Mastra's workflow engine has native retry logic. If a call to `get_facebook_analytics` or `get_twitter_analytics` fails due to temporary API limits, the workflow retries automatically based on your backoff configuration.

Use Mastra's human-in-the-loop feature. When your agent wants to write to the queue using `get_social_planner`, the workflow pauses and requests manual approval before executing the tool.

Yes, it does. Your MCP agent can use `list_metricool_profiles` to map out all connected accounts and then run separate workflow branches for each profile.

Yes, your API keys are handled securely by Vinkius's zero-trust MCP infrastructure, meaning your social tokens never touch Mastra's execution logs or your local storage.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript