How to Use the Mode Analytics MCP in OpenAI Agents SDK

Q: How do I fetch Mode Analytics reports using OpenAI Agents SDK?

Connect the server to your agent constructor. Call the listmodereports tool to see what is available, then pass the report ID to runmodereport to get current data.

Q: Does the server work with long-running Mode Analytics reports?

It does. You trigger the run and then poll getmodereportrun until the status turns to complete.

Trigger report runs and query Mode Analytics data directly from your OpenAI Agents SDK production pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mode Analytics MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate data discovery with OpenAI Agents SDK

Your agent scans your entire workspace using `list_mode_spaces` and `list_mode_reports`. It maps out available data without you writing a single manual query. Stop digging through web interfaces. Use `list_mode_queries` to pull raw SQL definitions straight into your agent's context for immediate analysis.

Execute live report runs via MCP Server

Fire off `run_mode_report` whenever your agent needs the latest numbers. It triggers the backend job and returns the run status instantly. Check the progress of long-running queries with `get_mode_report_run`. Your agent waits for completion before processing the final result set.

Manage team access and account details

Keep your agent aware of who is working on what by calling `list_mode_members`. It helps your agent understand the context of specific report modifications. Verify your current environment with `get_mode_account`. You'll know exactly which credentials your agent is using to pull sensitive business metrics.

Setup guide

Set up Mode Analytics 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 Mode Analytics tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Mode Analytics 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="Mode Analytics Agent",
            instructions="You have access to Mode Analytics 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 Mode Analytics. 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 Mode Analytics 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 Mode Analytics MCP in OpenAI Agents SDK

Connect the server to your agent constructor. Call the `list_mode_reports` tool to see what is available, then pass the report ID to `run_mode_report` to get current data.

Yes. The agent sees the error response from the tool call immediately. You can write custom logic to catch these failures and retry the operation.

Your agent only accesses what the provided API token allows. We use a zero-trust model where every request is scoped to your specific credentials.

It does. You trigger the run and then poll `get_mode_report_run` until the status turns to complete.

It sees whatever spaces your API token has permission to access. Use `list_mode_spaces` to confirm the scope of your current connection.

Use it with your favorite AI tools

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