How to Use the Avaza MCP in OpenAI Agents SDK

Q: Can an OpenAI Agents SDK system read Avaza invoices?

Yes. The agent will call the listinvoices tool to pull recent billing data. You can trace these exact API calls inside your OpenAI dashboard.

Q: What happens if the Avaza connection fails in the OpenAI Agents SDK?

Your agent can run getaccountcheck to verify the connection status. If it fails, your built-in guardrails can catch the error and trigger a fallback protocol.

Connect Avaza to your OpenAI Agents SDK production system for managed project tracking and timesheet generation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Avaza MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Drive Avaza Projects via OpenAI Agents SDK

Your multi-agent system needs a way to handle client deliverables without breaking constraints. Passing the Avaza MCP Server to your Agent constructor gives it direct access to `create_project` and `list_projects`. Handoffs work perfectly here. One specialized agent can run a `get_project` query to check status, then pass the context to a task-creation agent that fires off `create_task` and `update_task` calls while your guardrails validate every step.

Automated Timesheet Execution

Stop relying on humans to log their hours accurately. You can build an agent that reads git commits or Slack messages and automatically triggers `create_timesheet` to record the work. The tracing in your OpenAI dashboard will show exactly when the agent called `list_timesheets` to verify existing entries before adding new ones. This prevents duplicate billing records in your production database.

Read Invoices and Contacts

Fetching billing history usually requires writing custom API wrappers. With auto-discovery enabled, your agent instantly knows how to use `list_invoices` to pull financial records. It can cross-reference those invoices with `list_contacts` to build a complete picture of an account. Set `cacheToolsList=True` and those schema lookups happen instantly, keeping your response times low.

Setup guide

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

Create your Agent

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

Run the agent

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

Use MCPServerStreamableHttp with the Vinkius endpoint URL. Pass it in the mcp_servers list when initializing your agent. The SDK handles tool discovery automatically.

Yes. The agent will call the list_invoices tool to pull recent billing data. You can trace these exact API calls inside your OpenAI dashboard.

Your agent can run get_account_check to verify the connection status. If it fails, your built-in guardrails can catch the error and trigger a fallback protocol.

Everything runs inside a V8 Isolate Sandbox. Your agent connects to a single Vinkius endpoint token, keeping the actual underlying API keys completely hidden from your application code.

Vinkius uses ephemeral, zero-trust infrastructure. When your agent pulls user lists via the server, that data passes through memory and is never persisted on our end.

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