How to Use the Metricool MCP in OpenAI Agents SDK

Q: How does OpenAI Agents SDK handle Metricool rate limits?

The SDK monitors responses from the getunifiedsummary and getadsperformance endpoints. If the Metricool API signals a rate boundary, the client handles backoff automatically.

Q: Does OpenAI Agents SDK support tracing for getsocialplanner?

Yes, every execution of getsocialplanner is logged in your OpenAI developer dashboard. You see the exact input parameters and the JSON payload returned by the server.

Get raw social data and planner access directly inside your OpenAI Agents SDK pipelines with zero manual API setup.

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 OpenAI Agents SDK

Create your Vinkius account to connect Metricool to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Guardrails on Metricool MCP Server Data

The `get_unified_summary` tool pulls cross-channel marketing metrics directly into your OpenAI Agents SDK pipeline. By wrapping this call in an OpenAI Agents SDK stream, you inspect incoming Metricool profile statistics on the fly using our secure MCP transport.

Coordinate Cross-Channel Agent Handoffs

The `list_metricool_profiles` tool fetches all connected brand profiles to help your OpenAI Agents SDK router agent delegate tasks. A specialized Facebook agent gets the Metricool profile details while another handles scheduling checks.

Validate Post Schedules Before Publishing

The `get_social_planner` tool exposes future publishing queues directly to your OpenAI Agents SDK validation guardrails. Your OpenAI Agents SDK checks scheduled slots to ensure no overlapping Metricool updates occur.

Setup guide

Set up Metricool MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Metricool tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Metricool tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Metricool tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Metricool Agent",
            instructions="You have access to Metricool tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

The SDK monitors responses from the `get_unified_summary` and `get_ads_performance` endpoints. If the Metricool API signals a rate boundary, the client handles backoff automatically.

No, this MCP Server communicates with the live Metricool API to fetch real-time analytics. Your environment needs outbound network access to Vinkius to run tools like `get_instagram_analytics`.

Vinkius manages the authentication layer transparently. You provide a single Vinkius token to your `MCPServerStreamableHttp` configuration, which handles the underlying Metricool API keys.

Yes, every execution of `get_social_planner` is logged in your OpenAI developer dashboard. You see the exact input parameters and the JSON payload returned by the server.

Vinkius executes the MCP server in an ephemeral V8 sandbox, meaning no social media metrics or profile details are stored persistently on our servers. Your data passes directly to your OpenAI Agents SDK runtime.

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