How to Use the NCR Voyix MCP in Mastra AI

Q: Can I require human approval before Mastra AI modifies NCR Voyix order states?

Yes, you can configure the requireToolApproval flag on your Mastra AI agent before it executes tools like getorder. This pauses the workflow and alerts a manager to verify the transaction details before the agent proceeds.

Q: How do I register the NCR Voyix MCP Server tools inside a Mastra AI agent?

You instantiate the MCPClient with the Vinkius endpoint, call listTools(), and spread those tools directly into your agent's configuration. This exposes endpoints like listproducts and getsite to the agent's decision engine in one line of code.

Q: How is sensitive commerce site and catalog data protected on this MCP Server?

Every call to getsite and listcatalogs runs inside an isolated V8 sandbox that completely blocks external network access. Your store layout details and proprietary catalog structures remain entirely invisible to third parties, complying with corporate retail security standards.

Run reliable, multi-step commerce workflows with Mastra AI and the NCR Voyix integration.

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 Mastra AI

Create your Vinkius account to connect NCR Voyix to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Multi-Location Inventory Sync

The `list_sites` tool identifies every active retail location to let your Mastra AI agents check stock levels across your entire physical footprint. This tool feeds location IDs directly into your workflow steps, allowing the agent to map out regional store clusters automatically. If a store runs low on a high-demand item, Mastra's workflow engine catches the failure and triggers a backup search using `list_inventory`. The built-in retry logic prevents API rate limits from breaking your automated replenishment runs.

Conditional Loyalty Program Automation

The `get_loyalty_programs` tool fetches active promotional structures to evaluate customer eligibility inside your Mastra AI pipeline. Your agent parses these program rules to determine if a customer qualifies for specific discounts or tier upgrades. When a high-value customer is identified via `list_customers`, the agent executes conditional branching to apply targeted rewards. If the customer's purchase history matches the promotion criteria, the workflow automatically updates their profile without human intervention.

Mastra AI Error-Resistant Order Processing

The `list_orders` tool retrieves recent store transactions to monitor fulfillment status across your retail network. Mastra AI processes this list sequentially, passing each order ID to `get_order` to verify that payments and items match up perfectly. If an order shows a processing error, the agent initiates an exponential backoff routine to recheck the status. This MCP integration prevents temporary network hiccups from failing your supply chain pipelines or double-charging your customers.

Setup guide

Set up NCR Voyix MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All NCR Voyix tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "ncr-voyix-mcp-client",
  servers: {
    "ncr-voyix-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "NCR Voyix Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to NCR Voyix tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent NCR Voyix transactions"
);
console.log(result.text);

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 Mastra AI

Mastra AI uses its built-in workflow engine to execute automatic retries with exponential backoff when `list_inventory` hits API limits. This keeps your background syncs running smoothly without crashing your automation pipelines.

Yes, you can configure the `requireToolApproval` flag on your Mastra AI agent before it executes tools like `get_order`. This pauses the workflow and alerts a manager to verify the transaction details before the agent proceeds.

You instantiate the `MCPClient` with the Vinkius endpoint, call `listTools()`, and spread those tools directly into your agent's configuration. This exposes endpoints like `list_products` and `get_site` to the agent's decision engine in one line of code.

Yes, the client automatically detects whether the Vinkius endpoint is using Streamable HTTP or Server-Sent Events. This means your background workers can maintain persistent connections for heavy batch operations without manual protocol configuration.

Every call to `get_site` and `list_catalogs` runs inside an isolated V8 sandbox that completely blocks external network access. Your store layout details and proprietary catalog structures remain entirely invisible to third parties, complying with corporate retail security standards.

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