How to Use the BOSSDesk MCP in OpenAI Agents SDK

Q: How do I connect BOSSDesk to my OpenAI Agents SDK project?

You initialize the connection using the MCPServerStreamableHttp class. Point it at your Vinkius endpoint, and the SDK handles tool discovery automatically.

Q: Will BOSSDesk slow down my OpenAI Agents SDK agent?

Not if you cache the tool definitions. Set cacheToolsList=True in your configuration to keep latency low during agent execution.

Q: Can my OpenAI Agents SDK agent create tickets in BOSSDesk?

Yes, use the createticket tool. It takes the necessary parameters from your agent's context and pushes them to your desk.

Manage IT tickets and hardware assets directly from your OpenAI Agents SDK workflow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BOSSDesk MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

OpenAI Agents SDK ticket control

Your agent pushes updates to support requests using `add_ticket_note` or `update_ticket` without leaving your Python environment. You define the logic, and the agent executes the change against your live instance. Automated guardrails catch bad inputs before they hit your database. If the agent tries to modify a ticket incorrectly, the SDK halts the operation immediately.

Asset tracking for production agents

Retrieve hardware details using `get_asset` to feed context into your agent decision loops. This keeps your system state in sync with reality. Use `list_assets` to scan your entire inventory in one pass. The agent processes these records to identify hardware that needs replacement or servicing.

User and location discovery

Map tickets to specific people and places via `get_user` and `list_locations`. Your agents now understand the physical and human context of every incident. Querying these tools happens through the standard `MCPServerStreamableHttp` interface. You get raw data back, ready for your agent to process.

Setup guide

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

Create your Agent

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

Run the agent

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

You initialize the connection using the `MCPServerStreamableHttp` class. Point it at your Vinkius endpoint, and the SDK handles tool discovery automatically.

Not if you cache the tool definitions. Set `cacheToolsList=True` in your configuration to keep latency low during agent execution.

Yes, use the `create_ticket` tool. It takes the necessary parameters from your agent's context and pushes them to your desk.

The SDK raises an exception. You can catch this in your agent logic and decide whether to retry or log the failure.

Your ticket content, including user names and incident descriptions, stays within your secure Vinkius sandbox. We use token-based auth to ensure only your authorized agent hits the API.

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