# Marketplace Payout Utility AI Agent Connect

> Marketplace Payout Utility MCP handles the math behind your seller transactions. Your AI client uses it to calculate exact net payouts, pull specific commission rates, and check if a transaction meets all marketplace rules before you process it. It's a direct way to manage fee structures and seller earnings without manual spreadsheets.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_R7bOO1rU7xIAFMt1vy1qsI9CBVxhqaSqQryhFRYf/ai-agent-connect
- **Tags:** payout, fees, commission, seller, accounting

## Description

You can stop manually calculating how much to pay your sellers. This MCP gives your AI agent direct access to your marketplace's financial logic. Instead of guessing at commission tiers or checking refund statuses yourself, you just ask your agent to run the numbers. It handles the heavy lifting of deducting fees from gross sales to find the true net payout. You can also use it to audit your fee structures by pulling tier rates or checking if a specific transaction is actually eligible for a payout based on your current rules. It's built to keep your accounting accurate and your payouts consistent.

## Tools

### validate_transaction_eligibility
This tool checks if a specific transaction meets all marketplace rules for a payout. It's useful for confirming that a sale isn't blocked by a refund or other restriction.

### get_fee_percentage
This tool retrieves the exact commission rate for a seller or a specific product category. Use it to find out how much a sale will cost in fees.

### get_net_payout
This tool calculates the final amount a seller actually receives after all fees are taken out. It turns gross sales into net earnings instantly.

### list_tier_rates
This tool provides a full summary of all available fee percentages across your different seller tiers. It's the easiest way to see your entire fee structure at once.

## Prompt Examples

**Prompt:** 
```
What is the net payout for a $100 sale with a premium seller tier?
```

**Response:** 
```
The net payout for a $100 sale with a premium seller tier is $95.00, after a $5.00 fee.
```

**Prompt:** 
```
Is a sale of $50 eligible for payout if it was refunded?
```

**Response:** 
```
No, the transaction is ineligible for payout because it has been marked as refunded.
```

**Prompt:** 
```
What is the commission rate for a standard tier seller in the electronics category?
```

**Response:** 
```
The commission rate for a standard tier seller in the electronics category is 12%.
```

## Capabilities

### Net Payout Calculation
Your agent calculates the exact amount a seller earns after fees.

### Commission Auditing
The AI checks specific commission rates for any seller or category.

### Eligibility Verification
Your agent confirms if a transaction is ready for processing.

### Fee Structure Review
The AI pulls a full list of all available tier rates.

## Use Cases

### Seller Support
An agent answers a seller's question about why their payout amount looks a certain way.

### Payout Auditing
You run a batch of transactions through the agent to ensure fees were applied correctly.

### Financial Planning
Use the tier rates tool to model how different commission structures affect your revenue.

### Transaction Processing
The agent checks if a sale is eligible for payout before you trigger a transfer.

## Benefits

- Eliminates manual fee calculation errors.
- Provides instant verification of transaction status.
- Centralizes fee tier information for your AI client.
- Reduces the time spent auditing seller payouts.

## How It Works

Connecting this MCP to your AI client gives it immediate access to your financial logic.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Ask your agent a question about a specific sale or fee.
3. The agent calls the necessary tool to get the data.
4. Your agent provides the calculated answer or status immediately.

## Frequently Asked Questions

**How does this MCP calculate payouts?**
It uses the get_net_payout tool to subtract specific commission fees from the gross sale amount.

**Can I check if a refunded order can be paid out?**
Yes, you can use the validate_transaction_eligibility tool to check if a transaction is eligible for processing.

**Does it support different seller tiers?**
Yes, the MCP can retrieve specific rates for different tiers using the list_tier_rates tool.

**Which AI clients can use this?**
You can use this with any MCP-compatible client including Claude, Cursor, and Windsurf.

**Can I see the commission for a specific category?**
Yes, the get_fee_percentage tool allows your agent to look up rates for specific categories.

**How is the net payout calculated?**
The net payout is calculated by taking the gross sale price and subtracting the marketplace fee, which is determined by the seller's tier and the product category.

**Can I check if a specific sale is eligible for payout?**
Yes, you can use `validate_transaction_eligibility` to check if a sale meets the requirements for payout, such as checking if it has been refunded.

**How do I see the different fee tiers available?**
You can use the `list_tier_rates` tool to get a summary of all available fee percentages across different seller tiers.