How to Use the NCR Voyix MCP in OpenAI Agents SDK

Q: Can my OpenAI agent look up specific customers in NCR Voyix?

Yes. The agent calls the listcustomers tool to pull commerce customer records. You can constrain this action using the SDK's built-in guardrails to prevent unauthorized access to high-tier accounts.

Build production retail agents with OpenAI Agents SDK that query the NCR Voyix MCP Server for inventory and orders under strict execution guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NCR Voyix MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Route NCR Voyix Orders Across Specialized Agents

The `get_order` and `list_orders` tools feed live commerce data directly into your OpenAI agent workflows. You pass the order ID, and the agent pulls the exact fulfillment status, items, and customer references without writing custom API wrappers. Because the OpenAI Agents SDK supports handoffs, you can build a triage system. A frontline agent checks the order status, then hands off complex delays to a specialized logistics agent that runs `get_site` to verify the fulfillment center's operational state.

Map Retail Catalogs with Built-In Tracing

Running `list_catalogs` and `list_products` exposes your entire retail hierarchy to the agent. It reads the raw product structures and immediately understands which items belong to which categories. Every tool call is logged in the OpenAI dashboard. When an agent hallucinates a SKU or fails to find a match, you check the trace to see exactly what parameters it passed to `get_product` and fix the prompt.

Enforce Constraints on OpenAI Agents SDK

The `list_inventory` tool returns raw stock levels across your physical retail locations. Left unchecked, an agent might trigger massive stock reallocations based on bad math. The SDK lets you wrap this MCP Server in strict guardrails. You define rules that require human approval before the agent takes action on low inventory alerts, ensuring your supply chain stays predictable.

Setup guide

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

Create your Agent

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

Run the agent

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

Initialize an MCPServerStreamableHttp instance with your Vinkius endpoint URL. Pass it into the mcp_servers list when constructing your agent. The SDK handles tool discovery automatically.

Yes. The agent calls the list_customers tool to pull commerce customer records. You can constrain this action using the SDK's built-in guardrails to prevent unauthorized access to high-tier accounts.

Direct API calls require custom authentication logic, schema management, and error handling. The MCP standard abstracts this away, so your agent just sees callable functions like get_loyalty_programs.

It does. Setting cacheToolsList=True prevents the agent from re-fetching the schema on every execution. This cuts down latency when processing large batches of retail queries.

The server processes sensitive identifiers when executing list_customers and get_order. Vinkius isolates these operations within a V8 sandbox that destroys itself immediately after the HTTP response returns. No customer records touch persistent storage.

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