# Flip MCP MCP

> Flip connects your AI agent directly to Indonesian financial services. It automates everything from creating payment links for customers to running bulk payouts and validating bank accounts before you send a dime. Manage disbursements, monitor balances, and track every transaction without touching a banking portal.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** bulk-disbursements, payment-acceptance, bank-validation, payouts, financial-automation, indonesia-fintech

## Description

Dealing with payments in Indonesia used to mean jumping through complicated portals—one for checking the balance, another for submitting payroll, and yet a third just to verify a customer's account details. Now, you can handle those financial operations using natural conversation. You tell your agent what needs to happen, and it executes the transaction across all necessary systems. Whether you need to create an invoice link for a client or send real-time money transfers in bulk, this MCP handles the complexity behind the scenes. It gives your agent immediate access to crucial data, allowing you to process collections and disbursements entirely through chat. Because it’s available on Vinkius, you get one connection point that lets any compatible AI client manage all your financial workflows from a single dashboard.

## Tools

### create_bill
Generates a unique payment link (Bill) that customers use to pay you money.

### create_disbursement
Sends real-time money payouts to specific Indonesian bank accounts.

### get_balance
Retrieves the current, available balance in your Flip business account.

### get_bill
Fetches detailed information about a previously created payment link (Bill).

### list_cities
Lists supported geographical cities to ensure correct bank routing for payments.

### get_disbursement
Retrieves specific details for a payout that was already sent.

### list_banks
Lists all supported Indonesian banks and their identifying codes for accurate transaction entry.

### list_bills
Provides an overview of all payment links (Bills) you have generated recently.

### list_disbursements
Retrieves a list of all past and pending payouts you have sent out.

### list_payments
Lists recent incoming payments that your customers or clients have made to you.

### list_recurring_payments
Shows details and status for any automated, repeating payment tasks configured.

### validate_bank_account
Checks if a bank account number is valid and confirms the name of the account holder.

## Prompt Examples

**Prompt:** 
```
Validate bank account '12345678' at bank 'bca'.
```

**Response:** 
```
Validating account... I've checked the details with Flip. The account is valid and belongs to 'BUDI SANTOSO'. Would you like to proceed with a disbursement to this account?
```

**Prompt:** 
```
Create a payment link for 500,000 IDR titled 'Service Fee'.
```

**Response:** 
```
Bill created! I've generated a payment link for 500,000 IDR with the title 'Service Fee'. The Bill ID is 'bill_987'. Your customer can pay using this link: https://flip.id/p/abc123xyz.
```

**Prompt:** 
```
What is my current Flip account balance?
```

**Response:** 
```
Checking your balance... You currently have 15,250,000 IDR available in your Flip for Business account. You are ready to process your next batch of disbursements.
```

## Capabilities

### Run Bulk Payments
Initiate real-time money transfers to multiple Indonesian bank accounts or a single recipient.

### Process Customer Collections
Generate instant payment links that customers use to pay for services, tracking the funds automatically.

### Check Account Status
Get an up-to-the-second view of your business account balance and recent transaction history.

### Pre-Send Validation
Verify if a bank account exists and confirm the holder's name before running any payouts, eliminating errors.

## Use Cases

### Payroll Processing
The finance manager needs to pay 50 employees across three different banks. Instead of logging into the banking portal and entering 50 transactions, they ask their agent: 'Send disbursements for payroll.' The agent uses `create_disbursement` multiple times, confirming all payments are sent.

### Onboarding a New Client
A new client needs to pay an upfront service fee. The operations person asks the agent: 'Create a payment link for $1,500.' The agent uses `create_bill`, providing the client with a direct, trackable payment URL.

### Reconciling Accounts
The bookkeeper needs to verify if a payout attempt was successful. They ask: 'Show me details on yesterday's transfer.' The agent uses `list_disbursements` and then `get_disbursement` to pull up the exact status.

### Verifying Counterparties
Before sending funds to a new vendor, the team member needs assurance. They ask: 'Validate this account number.' The agent runs `validate_bank_account`, confirming both the bank and the owner's full name.

## Benefits

- Never worry about running out of funds. Use `get_balance` to check your current available liquidity before initiating any payout, preventing failed transfers.
- Automate invoicing effortlessly. Running `create_bill` generates a unique payment link instantly, letting you collect customer fees without manual invoice generation.
- Reduce fraud risk dramatically by running `validate_bank_account`. This tool confirms account existence and the owner's name before any money moves.
- Keep your books clean with transaction history. Use `list_payments` to see all incoming funds, or `list_disbursements` to track where every payout went.
- Handle complex payroll runs easily. You can execute multiple payments in bulk using `create_disbursement`, treating it like a single command.

## How It Works

The bottom line is: your AI client becomes a direct command center for all your Indonesian payments, letting you talk through complex finance tasks instead of navigating web forms.

1. Connect this MCP to your preferred AI client via Vinkius by entering your Flip Secret Key.
2. Ask your agent to perform a financial task, like 'Check my balance' or 'Create a bill for $500'.
3. The agent uses the available tools to query the live system and sends you a clear answer or confirms the action.

## Frequently Asked Questions

**How do I validate an Indonesian bank account before sending money?**
You can use the 'validate_bank_account' tool. Provide the bank code and account number, and the agent will call the Flip Bank Account Inquiry API to confirm the account is valid and return the registered holder's name.

**Can I check my current account balance using this server?**
Yes! The 'get_balance' tool retrieves the current available balance of your Flip for Business account, helping you ensure you have enough funds for your upcoming disbursements.

**How do I create a payment link for a customer?**
Use the 'create_bill' tool. Provide a title and the amount in IDR. The agent will generate a payment link (Bill) that you can share with your customer to collect the funds.

**How do I process multiple payouts at once using the create_disbursement tool?**
The tool supports bulk operations for efficient payout management. Instead of sending money one by one, you pass a list of recipient details (account number and beneficiary name) in a single request. This dramatically speeds up your disbursements compared to individual API calls.

**Can I check my past transactions using the list_payments or list_disbursements tools?**
Yes, these functions provide comprehensive records for accounting. You can filter results by date range, transaction ID, or status, giving you a full view of both funds received and payouts sent.

**What information do I need to set up the connection before using any function?**
You must provide your specific Flip Secret Key. This key authorizes your AI client to perform actions, like checking balances or initiating payments, and ensures that all transactions remain secure.

**How do I confirm which banks or cities are supported for payouts?**
Use the list_banks tool first, followed by list_cities. These commands pull a complete, up-to-date roster of every supported financial institution and geographical region in Indonesia, helping you prevent input errors.

**If I need to review the details of an existing payment link, what tool should I use?**
Use get_bill and provide the Bill ID. This command pulls all associated data—including the original amount, recipient information, and creation date—allowing you to verify its status without having to navigate your main web portal.