# BILL (Bill.com) MCP > BILL (Bill.com) MCP lets you manage accounts payable and receivable directly through your AI client. You can list vendors, pull specific bills, track invoices, and check customer details all without leaving your workflow. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** accounts-payable, accounts-receivable, invoicing, vendor-management, financial-automation, payments ## Description Managing payables and receivables used to mean bouncing between the dedicated portal, spreadsheets, and email threads. Now, you just talk to your agent. This MCP lets you orchestrate complex financial tasks—from checking pending vendor bills to pulling specific invoice amounts—using natural conversation. You can verify company contacts or check a chart of accounts structure instantly. Getting this connected through Vinkius means you don't have to worry about connecting multiple services; you just subscribe, and your AI client gets access to the whole financial catalog. It’s all about getting accurate data when you need it, making tedious data gathering obsolete. ## Tools ### get_bill Pulls all the specific details for one incoming bill record. ### get_customer Retrieves the full profile and account information for a specific customer. ### get_invoice Gets all the detailed information about one outgoing invoice record. ### get_user_profile Pulls basic, authenticated user details for verification purposes. ### get_vendor Fetches the complete profile and payment setup details for a specific vendor. ### list_accounts Provides a list of all available general ledger accounts (chart of accounts). ### list_bills Lists every bill record currently in the system for payables oversight. ### list_customers Retrieves a list summarizing all customers associated with your account. ### list_invoices Lists every invoice record currently in the system for receivables oversight. ### list_vendors Provides a comprehensive list of all registered vendors. ## Prompt Examples **Prompt:** ``` List all unpaid bills in my account. ``` **Response:** ``` I've retrieved your unpaid bills. You have 4 pending payments, including 'Office Rent' (ID: bill_1) and 'Cloud Services' (ID: bill_2). Would you like the due dates for these? ``` **Prompt:** ``` Find the vendor details for 'Global Logistics'. ``` **Response:** ``` I found a vendor matching 'Global Logistics' (ID: vend_992). Their primary contact is Mark Johnson, and they are currently set up for electronic payments. ``` **Prompt:** ``` Show my last 5 customer invoices. ``` **Response:** ``` Retrieving invoices... Your 5 most recent customer invoices include 'INV-1001' (Status: Paid) and 'INV-1005' (Status: Unpaid). Would you like to see the amount for the unpaid invoice? ``` ## Capabilities ### List Vendors Retrieves a complete list of all business vendors on file. ### Get Vendor Details Pulls the specific profile and contact information for one vendor by name or ID. ### List Bills Payable Generates a summary list of all incoming bills that need payment (accounts payable). ### Get Specific Bill Data Pulls the full, detailed record for a single bill. ### List Invoices Receivable Generates a summary list of all outstanding customer invoices (accounts receivable). ### Get Customer and Invoice Data Retrieves specific details for either a single customer profile or one particular invoice. ## Use Cases ### Disputing an Invoice Amount A user needs to check if the amount on an invoice is correct. They ask their agent to run `get_invoice` for 'INV-500'. The agent pulls the full record and confirms the billing cycle details, allowing the user to dispute it accurately. ### Quarterly Vendor Review A manager needs a list of all vendors who haven't been paid recently. They ask the agent to run `list_vendors`, filter by status, and get a concise report on accounts needing attention. ### Identifying Overdue AR An accountant needs to find which customers have invoices that passed their due date. Running `list_invoices` shows the list, and then running `get_customer` gives the billing contact information for follow-up. ### Initial Financial Audit A new employee needs to understand the company's structure. They ask the agent to run `list_accounts` first, and then use `get_user_profile` to confirm their own access permissions. ## Benefits - Stop searching through dashboards for status updates. You can ask to list all pending payments using `list_bills` and get a quick summary without opening the portal. - When you need to verify who you're paying, use `get_vendor` or `list_vendors`. This pulls detailed contact info immediately so you don't rely on old spreadsheets. - Need to know if a payment is overdue? You can check customer status by running `list_invoices` and then drill down with `get_invoice` for amounts owed. - Instead of logging into three different systems, run `list_accounts` to see your chart of accounts structure right from your agent. This helps keep your records accurate. - You can check the profile of any customer using `get_customer`. It’s perfect for confirming billing addresses or payment methods before running a report. ## How It Works The bottom line is, your AI agent handles the complex back-and-forth with BILL; you just ask a question. 1. Subscribe to this MCP and input your BILL Dev Key, User Name, Password, and Org ID credentials. 2. Your AI client makes an API call through the Vinkius platform using the established connection. 3. The agent processes the request, executes the necessary financial tool, and returns structured data directly to you. ## Frequently Asked Questions **Can BILL (Bill.com) MCP list all my vendors?** Yes, running `list_vendors` pulls a comprehensive list of every vendor you have on file with the system. **How do I check a single invoice status using BILL (Bill.com) MCP?** You use `get_invoice`, providing the specific invoice ID to pull all its associated details and current payment status. **Does this MCP allow me to create new bills?** No, this MCP is read-only for financial records. It allows you to retrieve data like listing or getting a bill, but it cannot execute payments or create new entries. **If I need general ledger info, what tool should I use with BILL (Bill.com) MCP?** Use `list_accounts`. This function provides the complete chart of accounts, which is necessary for general financial auditing and reporting.