# Billplz MCP MCP > Billplz connects your payment collections directly into your AI agent. Use this MCP to list, create, and track entire groups of bills and transactions from a single chat session. You can audit bank accounts, manage collection lifecycles, or check the status of specific payments without ever opening the Billplz dashboard. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** payment-gateway, collections, bill-management, transaction-tracking, fintech, online-payments ## Description You're dealing with payment collections—the process of grouping multiple debts, tracking who paid what, and keeping records clean. This MCP lets you do all that through natural conversation. Instead of jumping between tabs to find a bill's status or checking if a collection is active, you just talk to your agent. It talks to Billplz for you. You can build new collections, delete old bills, and pull detailed transaction histories for any record instantly. By connecting this MCP via Vinkius, you get all those finance operations powered by whatever AI client you prefer. Your entire payment workflow—from initial debt tracking to final reconciliation—runs through a simple prompt. ## Tools ### activate_collection Marks a specific group of bills as active so that collections can begin. ### create_bill Generates and tracks a brand new, unpaid bill for collection purposes. ### create_collection Sets up an entirely new grouping container to hold related bills. ### deactivate_collection Stops a bill collection group from processing payments or transactions. ### delete_bill Removes an unpaid bill record from the system entirely. ### get_bank_account Fetches and displays bank account details associated with a specific collection group. ### get_bill Retrieves all detailed information for one specified bill record. ### get_collection Pulls comprehensive data and status updates for a specific collection group. ### get_fpx_banks Lists all the FPX banks that the platform supports for transactions. ### list_collections Retrieves a summary list of every bill collection group currently in the system. ### list_transactions Generates a detailed transaction report for a single, specified bill. ## Prompt Examples **Prompt:** ``` List all active collections. ``` **Response:** ``` I've retrieved your collections. You have 3 active collections: 'E-store Payments' (ID: col_1), 'Monthly Subs' (ID: col_2), and 'Donations' (ID: col_3). ``` **Prompt:** ``` Show the status of bill bill_99283. ``` **Response:** ``` The bill bill_99283 for RM 50.00 is currently in 'paid' status. It was paid via FPX on March 28th. ``` **Prompt:** ``` List the last 5 transactions for bill_99283. ``` **Response:** ``` Retrieving transactions... I found one successful payment transaction for bill_99283. Amount: RM 50.00, Payment Method: Maybank2u. ``` ## Capabilities ### Manage the lifecycle of collections You can list existing bill groups, create new ones, and activate or deactivate them. ### Control individual bills and debts Create new unpaid invoices for collection or delete specific bills that are no longer relevant. ### Audit bank account details Retrieve the bank account information tied to a specific bill collection, ensuring you have the right payout details. ### Track payment history and transactions Pull detailed transaction lists for any given bill so you can reconcile payments accurately. ### Identify supported banks View a list of all FPX banks that Billplz supports, useful when setting up new payment channels. ## Use Cases ### Reconciling an unexpected payment batch The finance team needs to verify a large, recent deposit. They ask their agent to run `list_transactions` for the relevant bill ID and get a summary list of all related bills using `get_collection`. The AI client returns one single, clean report showing the amount, method, and date. ### Setting up a new payment group An e-commerce merchant needs to start tracking payments for a new product line. They ask their agent to first `create_collection`, then use `get_bank_account` to confirm the payout details, and finally list the collection ID. ### Cleaning up old debt records The accounting team is done with a specific billing cycle. They ask their agent to run `deactivate_collection`, then use `list_collections` to confirm it's marked inactive, ensuring no one accidentally processes payments against old data. ### Getting an overview of all outstanding debts A manager wants a quick health check. They ask their agent to run `list_collections`, which instantly returns the IDs and status of every collection group they manage, allowing them to prioritize follow-up actions. ## Benefits - Stop manually checking dashboards. You can list all bill collections or check a single collection's status instantly using the `list_collections` tool. - Audit money flow without logging in. The MCP lets you retrieve bank account details for any collection, which is critical before running payouts. - Better debt tracking means fewer missed payments. Use the agent to create new bills with `create_bill`, ensuring every outstanding amount is recorded immediately. - Full payment visibility comes from transaction reports. Running `list_transactions` gives you a clean breakdown of exactly how much was paid and when. - Control your data lifecycle by using tools like `deactivate_collection` or `delete_bill`. This keeps your records clean and prevents confusion over stale debt information. ## How It Works The bottom line is you get full access to complex payment operations without ever leaving your AI client conversation. 1. First, you subscribe to this MCP on Vinkius and enter your unique Billplz API key and environment details (production or sandbox). 2. Next, you initiate a request through any compatible AI agent. You just tell it what you need, like 'List all active collections.' 3. Your agent calls the necessary tool, retrieves the data from Billplz, and hands you a clean, summarized answer in your chat window. ## Frequently Asked Questions **How do I check payment status using list_transactions?** You use `list_transactions` by providing a specific bill ID. This tool generates a detailed log of every payment attempt or success, giving you the full picture of how that bill was settled. **Can I get all my active collections using list_collections?** Yes. Running `list_collections` provides an immediate summary of every collection group available, so you can see what is currently being tracked for payment. **How do I confirm the bank details for a collection?** Use the `get_bank_account` tool. You just need to specify the collection ID, and it pulls the necessary banking information so you know where payments are going. **What is the difference between create_bill and get_bill?** You use `create_bill` when you need to generate a new unpaid invoice. You use `get_bill` when you already have an ID and just want to view all of its current details. **Do I need to worry about old, inactive collections?** You can manage this with `deactivate_collection`. This tool marks the group as paused, keeping your records clean without deleting necessary historical data. **How do I use get_collection to check deep details about a specific collection ID?** It provides every piece of metadata for that single collection. You'll see its current status, the attached bank account details, and creation date—useful when auditing a specific fund. **If I try to delete an unpaid bill using delete_bill, are there any restrictions?** Yes, the system blocks deletion if active transactions or associated collections exist. You must resolve or archive all payments before running delete_bill successfully. **Which banks can I process payments with by running get_fpx_banks?** This tool lists every FPX bank currently supported by the platform. This confirms which payment methods your clients will accept, giving you a clear list before you create new collections. **Can I check if a specific bill has been paid?** Yes! Use the `get_bill` tool with the Bill ID. Your agent will fetch the latest status, including whether it is 'paid' or 'due'. **How do I create a new payment collection?** Simply ask the agent to `create_collection` and provide a title. It will create the collection in your Billplz account and return the new Collection ID. **Can I see the list of FPX banks supported for online banking?** Yes. Use the `get_fpx_banks` tool to retrieve a real-time list of all banks currently supported by the Billplz FPX gateway.