How to Use the Commission Factory MCP in Mastra AI

Q: How do I register the Commission Factory MCP Server in Mastra AI?

Install the package using npm install @mastra/mcp@latest in your project. Then, initialize a new MCPClient with your Vinkius endpoint URL and spread mcpClient.listTools() into your agent's tool configuration.

Q: How do I configure Mastra AI to require approval for Commission Factory tools?

You can enable the requireToolApproval flag on sensitive tools like getmerchantdetails. This pauses the workflow and alerts an operator, ensuring no automated agent makes unauthorized queries or changes.

Build self-healing affiliate workflows that track Commission Factory transactions and auto-retry failures using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Commission Factory MCP to Mastra AI

Create your Vinkius account to connect Commission Factory 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 Commission Factory with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build resilient workflows with this MCP Server

Network drops and API limits shouldn't break your tracking pipelines. Mastra lets you wrap tools like `list_merchant_transactions` in resilient workflows that automatically retry when an API call fails. If the network hiccups while fetching your daily sales, the engine handles the backoff and tries again. You can also set up human-in-the-loop approvals for sensitive actions. For example, before pulling large datasets or running heavy calculations, you can configure the system to wait for an admin's green light before proceeding.

Automate merchant program audits

Managing thousands of affiliates requires constant oversight. You can deploy this MCP Server to let your agents run `list_merchant_affiliates` to pull your current program members, then processes their performance metrics in sequential steps. If an affiliate's conversion rate drops below a certain threshold, the workflow can trigger a notification. It gives you a hands-off way to monitor your merchant campaign health without manual daily checks.

Track and calculate affiliate payouts

Calculating correct payouts across multiple campaigns is tedious. By combining `get_performance_summary` with `get_transaction_details`, your agents can audit specific conversions and flag discrepancies automatically. The workflow engine passes the raw transaction data through your custom business logic. You can write simple TypeScript branches to categorize sales, verify commission rates, and prepare clean reports for your accounting team.

Setup guide

Set up Commission Factory 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 Commission Factory 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: "commission-factory-mcp-client",
  servers: {
    "commission-factory-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Commission Factory 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 Commission Factory. 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 Commission Factory 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 Commission Factory MCP in Mastra AI

Install the package using `npm install @mastra/mcp@latest` in your project. Then, initialize a `new MCPClient` with your Vinkius endpoint URL and spread `mcpClient.listTools()` into your agent's tool configuration.

Yes, Mastra's built-in workflow engine lets you define retry policies with exponential backoff. If `list_affiliate_transactions` hits an API limit, the system pauses and retries the request automatically without crashing your app.

You can enable the `requireToolApproval` flag on sensitive tools like `get_merchant_details`. This pauses the workflow and alerts an operator, ensuring no automated agent makes unauthorized queries or changes.

Yes, it automatically configures the connection using either Streamable HTTP or SSE depending on what the endpoint supports. You don't have to write any boilerplate code to establish the connection.

Your merchant campaign data and affiliate lists are completely isolated. Vinkius runs the MCP Server in an ephemeral V8 sandbox, ensuring your API tokens never persist in memory or get exposed to third-party scripts.

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