How to Use the Hiveage MCP in OpenAI Agents SDK

Q: How do I use the OpenAI Agents SDK to find overdue Hiveage invoices?

Your agent can call the listinvoices tool with a 'duedatebefore' filter to get a list of all overdue invoices. From there, it can iterate through the list to take further action, like sending reminders.

Q: Can I record payments in Hiveage with an agent built on the OpenAI Agents SDK?

Yes. The recordpayment tool is designed for this. Your agent passes the invoice hash, amount, date, and payment method, and the server updates the invoice in your Hiveage account.

Q: What's the best way to connect the OpenAI Agents SDK to my Hiveage account?

You'll instantiate the MCPServerStreamableHttp client with the unique URL Vinkius provides. Pass that server instance to your Agent constructor, and it will auto-discover all the available Hiveage tools.

Build production financial agents with the OpenAI Agents SDK to run your Hiveage invoicing and payment tracking.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hiveage MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Your Billing Cycle

This server gives your agent direct access to your Hiveage account. You can have it `list_invoices` to find overdue accounts, then use `get_customer_details` to get the right contact info for a follow-up. With the OpenAI Agents SDK, you can apply guardrails to these actions. That means your agent can't accidentally `send_invoice_email` to the wrong person or `record_payment` twice. Every step is part of a managed, observable workflow, not just a blind API call.

Build Multi-Agent Financial Workflows

Assign different financial tasks to specialized agents. One agent's job is to monitor for new payments using `list_invoice_payments`. When it finds one, it hands off to another agent that formally records it with `record_payment`. This entire handoff is visible and traceable in your OpenAI dashboard. You get a full audit log of which agent did what and when. It’s how you build a reliable accounting system instead of a simple script.

A Secure Hiveage MCP Server

Connect your agent to Hiveage to manage your core financial data. Use `list_billing_items` to pull your standard services and rates, or use `list_tax_profiles` to apply the correct tax rules to a new invoice. This MCP Server handles the connection and authentication. Your agent just calls the tools it needs. You don't have to manage API keys or refresh tokens in your agent's code, which keeps your Hiveage credentials secure.

Setup guide

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

Create your Agent

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

Run the agent

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

Your agent can call the `list_invoices` tool with a 'due_date_before' filter to get a list of all overdue invoices. From there, it can iterate through the list to take further action, like sending reminders.

Yes. The `record_payment` tool is designed for this. Your agent passes the invoice hash, amount, date, and payment method, and the server updates the invoice in your Hiveage account.

You'll instantiate the `MCPServerStreamableHttp` client with the unique URL Vinkius provides. Pass that server instance to your Agent constructor, and it will auto-discover all the available Hiveage tools.

It exposes tools for managing customers, invoices, estimates, and payments. You can list records with tools like `list_customers` and `list_invoices`, get details with `get_invoice_details`, and perform actions like `record_payment` and `send_invoice_email`.

No, it doesn't store your data. The server acts as a stateless proxy, passing your requests to Hiveage and streaming the response back to your agent. All customer and invoice information is only held in memory for the duration of that single transaction.

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