How to Use the Wave Accounting MCP in OpenAI Agents SDK

Q: What if I mess up a customer record in Wave Accounting using the OpenAI Agents SDK?

You can delete an account permanently with deleteaccountingcustomer, but remember, that action is irreversible. You'll want to run getcustomerdetails first just to be sure you have the right ID.

Q: Can the OpenAI Agents SDK handle complex invoicing in Wave Accounting?

Yeah, it can. Your agent calls createdraftinvoice, passing a JSON array of items and a customer ID. After that, approvedraftinvoice moves it to an active billing state.

Q: Is there a way to list all invoices with the OpenAI Agents SDK?

Absolutely. The tool listaccountinginvoices handles this. It gives you a full list of every invoice issued by your Wave Accounting business, helping your agent build reports.

Manage money flows and client data for your OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Wave Accounting MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Customer Records

Need to onboard a new client? Start by calling `create_accounting_customer`. This tool accepts the customer's name and email, creating a fresh record in Wave Accounting. You can also check existing accounts using `list_accounting_customers` or pull deep data for one person with `get_customer_details`. If you need to modify an existing user’s info—say, fixing their address—you just run `update_customer_profile`, passing the unique customer ID. Remember that deleting a record is permanent; use `delete_accounting_customer` only when absolutely sure.

Draft and Finalize Invoices

Generating invoices shouldn't be complicated. First, run `create_draft_invoice`, supplying the customer ID and a list of line items in JSON format. Once the draft is ready for review, you finalize it using `approve_draft_invoice`. This moves the invoice to an unpaid/saved status. If your agent needs to clean up work-in-progress billing, use `delete_draft_invoice` to remove unfinalized drafts. You won't find a delete option for saved or paid invoices via this endpoint.

Monitor Accounting Activity

Your agent can check the full accounting picture using Wave Accounting tools. Start by listing all recorded transactions with `list_accounting_invoices`. If you need to see every client, running `list_accounting_customers` gets that list immediately. For deeper dives into specific billing events, your agent calls `get_invoice_details` for a full invoice breakdown, or uses `get_customer_details` if it just needs basic profile info on one customer.

Setup guide

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

Create your Agent

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

Run the agent

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

You pass the MCP Server definition into your Agent constructor. The agent auto-discovers every tool, so you don't need to write any boilerplate code. You just tell it what job needs doing.

You can delete an account permanently with `delete_accounting_customer`, but remember, that action is irreversible. You'll want to run `get_customer_details` first just to be sure you have the right ID.

Yeah, it can. Your agent calls `create_draft_invoice`, passing a JSON array of items and a customer ID. After that, `approve_draft_invoice` moves it to an active billing state.

Absolutely. The tool `list_accounting_invoices` handles this. It gives you a full list of every invoice issued by your Wave Accounting business, helping your agent build reports.

This server touches customer names and email addresses. Always make sure your agent's instructions are scoped down to only accessing necessary records, like specific Customer IDs.

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