How to Use the Working Capital Calculator MCP in OpenAI Agents SDK

Calculate cash conversion cycles and working capital needs in production with the Working Capital Calculator and OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Working Capital Calculator MCP to OpenAI Agents SDK

Create your Vinkius account to connect Working Capital Calculator to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Working Capital Calculator with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Calculate cash conversion cycle duration via MCP

The `calculate_cash_conversion_cycle` tool tells your agent exactly how many days your cash is trapped in operations. You feed it days inventory outstanding, days sales outstanding, and days payable outstanding. The math is simple. It subtracts your payable days from the sum of your inventory and receivable days. Your OpenAI Agents SDK guardrails catch bad inputs before they hit the MCP. If a user passes negative days, the agent rejects it. You get a clean cycle duration every time.

Convert cycle days to dollar amounts

The `calculate_monetary_working_capital` tool takes your cycle timeframe and multiplies it by your daily cost of goods sold. A 45-day cycle means nothing without the dollar figure. This gives you the exact cash buffer you need to keep the lights on. This is where the tracing in your OpenAI dashboard pays off. You can watch the agent pull the turnover data, run the calculation, and hand off the result to your finance agent. No silent failures. Just hard numbers.

Get full financial cycle profiles

The `get_financial_cycle_summary` tool returns every constituent period and the final calculated values in a single payload. Sometimes you need the whole picture at once. Your agent parses the JSON and formats it for the CFO. You set up specialized agents in your SDK to handle different parts of this report. One agent checks the inventory days. Another checks the receivables. They all feed into a master agent that delivers the final summary.

Setup guide

Set up Working Capital Calculator 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 Working Capital Calculator tools at runtime.
3

Create your Agent

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

Run the agent

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

Install the SDK and create an MCPServerStreamableHttp object with your MCP URL. Pass that object into the mcp_servers list when you initialize your Agent. The tools auto-discover.

Yes, but your agent's guardrails should block them first. The MCP will calculate the math if you force it, but negative days break the financial logic. Set up a validation step in your agent before calling the tool.

No. The MCP only processes the numbers you send in the request and returns the result. It does not persist your inventory days, receivables days, or payables days. Your data stays in your own environment.

Enable tracing in your SDK configuration to send execution logs to the OpenAI dashboard. You will see the exact inputs and outputs for every calculation. This makes debugging financial logic trivial.

Yes. You can filter the auto-discovered tools when you pass the MCP configuration to your agent. Just specify the exact tool names you want to expose. This keeps your agent focused on the right financial metrics.

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