# PingPong MCP

> PingPong connects your AI agent directly to a global multi-currency payment system, letting you manage complex cross-border finances without logging into any dashboard. Your agent can instantly check real-time balances across multiple accounts, list all receiving channels for different e-commerce platforms, audit transaction histories, and even initiate payouts—all through natural conversation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** cross-border-payments, multi-currency, transaction-history, payouts, financial-operations

## Description

Managing money across borders used to mean hopping between dashboards, cross-referencing currencies manually, and waiting on bank wires. This MCP changes that. It lets your AI client act as a real-time treasury assistant for your e-commerce operations. You can ask it to list all your global receiving accounts or check the total balance in USD across every currency you use. Need to audit sales? Your agent pulls up transaction histories, letting you filter by status and type instantly. If funds are ready to go, you can trigger a payout without leaving your chat window. Because Vinkius hosts this MCP, it means you connect once from any compatible AI client and get full visibility into managing global accounts, balances, and payouts.

It keeps your capital accurate and your cross-border payments moving whether you're running one store or twenty.

## Tools

### create_payout
This tool initiates a new fund withdrawal or payout to an external account.

### get_account_details
Retrieves detailed information and metadata for specific global receiving accounts.

### get_balance
Provides the current, real-time balance for a specified account in any supported currency.

### get_exchange_rates
Pulls up live foreign exchange rates so you know exactly how much money you'll receive when converting currencies.

### get_payout_status
Checks the current status of a specific payout, telling you if it’s processing or complete.

### get_sales_summary
Gets a high-level summary report of your total global sales activity over a given period.

### get_vcc_balance
Checks the current balance available on any virtual card you use for transactions.

### list_accounts
Lists all global receiving accounts associated with your company's profile.

### list_store_accounts
Retrieves a list of specific bank or payment accounts tied to individual e-commerce stores.

### list_transactions
Fetches the detailed history of all account transactions for auditing purposes.

## Prompt Examples

**Prompt:** 
```
List all my PingPong receiving accounts.
```

**Response:** 
```
I've retrieved your global receiving accounts. You have 5 active accounts, including receiving channels for Amazon US, Shopify, and Walmart. Would you like to check the balance for any of them?
```

**Prompt:** 
```
What is my current balance in USD across all accounts?
```

**Response:** 
```
Your total current balance across all USD accounts is approximately $45,200. This includes $32,000 in your main receiving account and $13,200 in your VCC balance. Would you like a detailed breakdown?
```

**Prompt:** 
```
Check the status of payout 'PAY-8821'.
```

**Response:** 
```
I've checked the status for payout 'PAY-8821'. It is currently 'Processing' by the receiving bank. Funds are expected to arrive in your destination account within 24 hours.
```

## Capabilities

### List all receiving bank channels
The agent retrieves a list of every global account associated with your e-commerce operations.

### Monitor real-time multi-currency balances
You can get the current cash balance across multiple currencies and different types of accounts (like VCCs).

### Audit transaction history
The agent pulls comprehensive lists of transactions, allowing you to filter by status or currency.

### Initiate fund transfers and track them
You can request payouts to suppliers and check the live status of those payments.

### Analyze sales performance metrics
The system pulls high-level summaries of global sales activity.

## Use Cases

### A seller needs to reconcile funds from three different global marketplaces.
The agent uses `list_store_accounts` to get all platform IDs, then calls `get_balance` for each one. It reports back a consolidated total balance in USD and EUR, telling the seller exactly how much is available across all channels.

### A CFO needs to verify that recent payouts cleared successfully.
The CFO asks the agent about 'PAY-456'. The agent uses `get_payout_status` and provides a clear status update, confirming the expected arrival time. This prevents delays because of manual follow-up.

### An operations team member needs to check global sales performance vs. current cash.
The agent first runs `get_sales_summary` to see recent revenue spikes, then uses `get_vcc_balance` and `get_balance` to ensure there's enough liquid capital ready for planned expenditures.

### A business owner needs a quick overview of all accounts before making decisions.
The agent executes `list_accounts`, showing the full global network. Then, it combines this with `get_account_details` to give a holistic view of account readiness and available funds.

## Benefits

- You instantly know where every dollar is. By using `get_balance`, you get real-time cash totals across all currencies, eliminating the need to log into multiple banking portals just to check liquidity.
- Audit trails are simple. Instead of digging through complicated spreadsheets, asking your agent to run `list_transactions` gives you a filtered, readable history instantly.
- Managing stores is streamlined. You can use `list_store_accounts` and `get_account_details` together to monitor payout readiness for every platform without clicking through dozens of store dashboards.
- Payouts are controlled from text. When funds are ready to move, you just call the `create_payout` tool, and your agent monitors the result using `get_payout_status`.
- Currency uncertainty is gone. Use `get_exchange_rates` before planning any large transfer so you know exactly what the final amount will be.

## How It Works

The bottom line is that you talk to your AI client naturally, and it handles the complex accounting queries using PingPong’s systems.

1. Subscribe to the PingPong MCP and provide your unique App ID and App Secret.
2. Connect this MCP to your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent a financial question, like 'What's my balance in EUR?' or 'List all store accounts.' The tool runs the query and gives you a direct answer.

## Frequently Asked Questions

**How can I check my balance using the PingPong MCP?**
You use the `get_balance` tool. Just ask your agent for the specific currency or account type, and it provides a real-time cash total across all linked accounts.

**Can I see transactions from multiple e-commerce stores with PingPong MCP?**
Yes. You can run `list_store_accounts` to identify the relevant platforms, and then use `list_transactions` to get a unified view of activity across those sources.

**What do I need to know before initiating payouts with PingPong MCP?**
Always check two things first: Use `get_exchange_rates` to confirm the conversion rate, and then use `get_payout_status` on a related payout to ensure funds are ready to move.

**Is PingPong MCP only for US dollars?**
No. The platform handles global payments. You can ask the agent for balances and rates in any currency your business uses, giving you multi-currency visibility.

**Does PingPong MCP help with VCCs?**
Yes. It provides dedicated tools like `get_vcc_balance` so you can check the available funds on virtual cards used for your commerce operations.