How to Use the Hiver MCP in OpenAI Agents SDK

Q: Can my OpenAI Agents SDK system modify thread status in Hiver?

Yes. The agent uses updatethreadstatus to change thread states or assign ownership. You can set up guardrails in your SDK code to inspect these actions before they execute.

Q: Does the OpenAI Agents SDK support drafting emails via the Hiver MCP Server?

Yes, your agent can call createshareddraft to write responses. The draft is saved directly in Gmail, letting your human support team review it before it goes live.

Q: How do I verify my credentials before running the agent?

You can call testhiverauth and getapistatus to confirm your connection is active. Running these checks during startup prevents your agent from failing mid-run due to expired tokens.

Give your OpenAI Agents SDK production deployment direct access to Hiver via this MCP Server without exposing raw credentials.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hiver MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Control support triage with OpenAI Agents SDK

This MCP Server exposes tools like `list_shared_inboxes` and `list_inbox_conversations` so your agents can monitor incoming emails. Instead of raw API scraping, your agent gets clean JSON lists of conversations directly from your workspace. By calling `update_thread_status`, the agent can assign threads or close out resolved tickets based on your team's rules. This replaces manual routing entirely, letting your production agents handle triage in real time.

Draft responses directly inside Gmail threads

The `create_shared_draft` tool lets your agent write draft replies inside your shared team inbox. Your human agents see these drafts instantly inside Gmail, allowing them to review, edit, and send without context switching. To write accurate drafts, the agent calls `get_conversation_details` to read the entire historical thread. This ensures the generated text matches the context of previous customer messages before saving the draft.

Manage team tags and assignments dynamically

The `list_inbox_tags` and `search_team_members` tools let your agents find the right person and label for any incoming issue. Your OpenAI Agents SDK setup can query team availability and apply the correct category immediately. Using `search_tags_by_name`, your agent matches customer intent to your existing Hiver tag structure. This keeps your shared inbox organized without letting agents hallucinate new, non-existent labels.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the SDK and register the Hiver MCP server using the streamable HTTP parameters. Pass the server instance directly into your Agent constructor to let your agent discover the 12 available tools.

Yes. The agent uses `update_thread_status` to change thread states or assign ownership. You can set up guardrails in your SDK code to inspect these actions before they execute.

Yes, your agent can call `create_shared_draft` to write responses. The draft is saved directly in Gmail, letting your human support team review it before it goes live.

You can call `test_hiver_auth` and `get_api_status` to confirm your connection is active. Running these checks during startup prevents your agent from failing mid-run due to expired tokens.

The server runs in an isolated Vinkius sandbox, ensuring email threads and drafts are never stored. Your Gmail data passes directly between the Hiver API and your agent with zero persistent caching 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