How to Use the Katana MCP in OpenAI Agents SDK

Q: How does the OpenAI Agents SDK handle creating a Katana sales order?

The agent uses the createsalesorder tool. You can configure the SDK's built-in guardrails to prompt for human approval before the agent executes the final API call, adding a critical layer of safety.

Q: What's the best way to check Katana inventory with the OpenAI Agents SDK?

Have your agent call getinventorybyvariant for specific items or listinventory for a general overview. The SDK makes these calls asynchronously, so your agent can perform other tasks while waiting for Katana's response.

Build production-grade ERP agents for Katana with the OpenAI Agents SDK's built-in safety guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Katana MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Create Sales Orders Without Risk

Your agent can draft sales orders automatically. Use the OpenAI SDK's guardrails to require human confirmation before the agent actually runs `create_sales_order`. This prevents accidental orders from hitting your production ERP. You can also build specialized agents. One agent could use `list_customers` and `list_products` to find the right details, then hand off the final order payload to a separate, trusted agent whose only job is to execute `create_sales_order`. It's a clean separation of duties.

Monitor Manufacturing in Real-Time

Give your agent the ability to track your entire production line. It can check on `list_manufacturing_orders` to see what's being built and cross-reference that with `list_materials` to flag potential shortages. The OpenAI dashboard gives you a full trace of every tool call. You'll see exactly when your agent checked inventory or sales orders, making it easy to debug why it decided to flag a specific manufacturing order.

A Katana MCP Server for Python Agents

Your Python agent discovers all 11 Katana tools automatically. There's no need to manually define function schemas for `list_suppliers` or `get_sales_order`. Just connect the MCP server and your agent knows what it can do. For speed, set `cacheToolsList=True` in the constructor. Your agent won't have to fetch the tool list on every startup, which is ideal for production deployments where you need fast cold starts.

Setup guide

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

Create your Agent

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

Run the agent

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

The agent uses the `create_sales_order` tool. You can configure the SDK's built-in guardrails to prompt for human approval before the agent executes the final API call, adding a critical layer of safety.

You handle this at the agent instruction level. By not giving it tasks that require certain tools, or by using agent handoffs for sensitive operations, you control what it does. This Katana MCP server exposes all tools by default for maximum flexibility.

Have your agent call `get_inventory_by_variant` for specific items or `list_inventory` for a general overview. The SDK makes these calls asynchronously, so your agent can perform other tasks while waiting for Katana's response.

Yes. This is a standardized MCP server. You write zero API integration code, and the same server works with other compatible clients, not just OpenAI.

Your sales order, customer, and inventory data is streamed directly between your agent's environment and the Vinkius-managed server. Vinkius isolates each request, and OpenAI's platform provides tools for managing data handling within your agent's own logic.

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