# Billplz MCP for AI Agents AI Agent Connect > Billplz MCP lets you manage your payment collections, bills, and transactions directly through your AI agent. Stop switching tabs to check payment statuses or create new bills. You can list collections, track individual bill statuses, and audit transaction histories in one place. It's built for merchants and finance teams who need to handle high-volume payments without the manual overhead. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_EMh1ZotmqYqe7G6KpBY7CYyqvtqQwojzGg5uPEpq/ai-agent-connect - **Tags:** payment-gateway, collections, bill-management, transaction-tracking, fintech, online-payments ## Description Imagine you're running an online store and a customer asks about a payment status. Usually, you'd have to log into your payment gateway, find the specific bill, and check the history. With the Billplz MCP, you just ask your AI agent. It pulls the data instantly. You can create new bill collections for different products, toggle them on or off, and see exactly which bank accounts are linked to your payments. It even handles the nitty-gritty like listing available FPX banks or pulling transaction logs for reconciliation. Instead of digging through a dashboard, you're just having a conversation about your money. It's one of the many ways Vinkius makes it easy to plug your existing business tools into your daily workflow. You get a clear view of your revenue and a way to manage your billing cycle without ever leaving your chat interface. ## Tools ### create_collection Create a new bill collection for a product or service. It helps organize your billing into logical groups. ### deactivate_collection Turn off a specific collection. Use this to stop accepting payments for a discontinued item. ### delete_bill Remove an unpaid bill from the system. This is useful for canceling orders that shouldn't be processed. ### get_bank_account See the bank details for a specific collection. Use this to verify where your funds are being deposited. ### get_bill Pull the specific details of a single bill. This lets you quickly check the amount and status of a customer's payment. ### get_collection Retrieve the details of a specific collection. Use this to see the overview of a billing group. ### get_fpx_banks List all banks that support FPX payments. This helps you see what options are available to your customers. ### list_collections See a list of all your bill collections. Use this to get a high-level view of your active billing groups. ### list_transactions Get a full list of transactions for a specific bill. This is the go-to tool for reconciling complex payments. ### activate_collection Turn on a collection to start accepting payments. Use this when launching a new product or service. ### create_bill Generate a new bill for a specific collection. This is how you actually charge your customers. ## Prompt Examples **Prompt:** ``` Show me all my active bill 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:** ``` What's 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 few transactions for bill_99283. ``` **Response:** ``` Retrieving transactions... I found one successful payment transaction for bill_99283. * **Amount:** RM 50.00 * **Payment Method:** Maybank2u ``` ## Capabilities ### Create new bill collections Create a new collection for a specific product or service. ### Toggle collection status Activate or deactivate collections to control what's live. ### Generate new bills Create a specific bill for a customer under an active collection. ### Check payment status Get specific details for a bill to see if it's paid or pending. ### Audit transaction history List all transactions for a specific bill to reconcile payments. ### Verify bank details Get the bank account information attached to a specific collection. ### Browse FPX banks See which banks are supported for FPX payments. ## Use Cases ### Checking customer payment status A merchant gets a DM about a payment status. They ask the agent to check the status of a specific bill using get_bill. ### Auditing bank deposit routes A finance person needs to audit a specific account. They use get_bank_account to see where a collection is sending money. ### Testing payment flows in sandbox A developer is testing a new checkout flow. They use create_bill and list_transactions in a sandbox to verify the flow. ### Launching new product billing A store owner wants to launch a new product. They use create_collection and activate_collection to set up the billing group. ## Benefits - Stop manual dashboard navigation by using list_collections to see all your active payment groups in one go. - Speed up order fulfillment by using create_bill to generate customer invoices instantly from your chat. - Simplify reconciliation by using list_transactions to pull every payment attempt for a specific bill. - Control your storefront more effectively with activate_collection and deactivate_collection to manage live billing. - Verify your setup quickly with get_bank_account and get_fpx_banks to ensure your payment routes are correct. - Clean up your records easily with delete_bill to remove unpaid invoices that are no longer relevant. ## How It Works The bottom line is you can manage your entire Billplz payment lifecycle through a chat interface instead of a web dashboard. 1. Subscribe to the Billplz MCP on Vinkius. 2. Input your Billplz API key and choose your environment (production or sandbox). 3. Start asking your AI client to list bills or create collections. ## Frequently Asked Questions **What can I do with the Billplz MCP?** You can manage your entire payment lifecycle through a chat interface. This includes creating new collections, generating bills for customers, and checking payment statuses in real time. **How does Billplz MCP help my e-commerce store?** It lets you handle customer inquiries faster. Instead of logging into a dashboard, you can ask your AI agent to pull specific bill details or transaction histories instantly. **Can I use Billplz MCP to check if a customer paid?** Yes, you can ask your agent to retrieve the status of any specific bill. It will tell you if the payment was successful, the amount, and the date it was settled. **How do I manage my collections with Billplz MCP?** You can use your AI client to list all your active collections, create new ones for different products, or toggle them on and off to control what's live. **Can Billplz MCP help with bank reconciliation?** It does by allowing you to pull full transaction lists for specific bills. You can also check which bank accounts are linked to your collections to verify your setup. **Can I use Billplz MCP to create new bills?** Yes, your AI agent can generate new bills for your customers under an active collection, making it much faster to handle new orders. **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.