# Billit MCP MCP > Billit manages your e-invoicing and accounting processes directly through conversation. List invoices, track expenses, and manage customer records without switching between tabs or logging into multiple portals. Connects all your financial data—from receipts to final bills—to any AI agent. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** e-invoicing, peppol, accounting, expense-tracking, crm, tax-compliance ## Description Need to handle billing from a chat window? Billit connects your e-invoicing system to your preferred AI client so you can run complex accounting tasks using natural conversation. You ask for the information, and it happens. Your agent reads detailed invoices across the Peppol network, checks who your clients are, or pulls receipts into one summary. This capability lets you handle everything from initial expense logging to generating a final bill in one go. Since Vinkius hosts this MCP, all these financial tools are available under one connection point for your AI client, meaning you don't need dozens of API keys just to manage your day-to-day books. ## Tools ### create_invoice Generates a completely new invoice record in the system. ### create_party Adds a brand-new customer or supplier entity to your contact list. ### get_company_info Pulls the official, authenticated core details for your company. ### get_invoice Retrieves all the specific details for a single invoice number you provide. ### get_party Checks and pulls out all data related to one specific party (client or supplier). ### list_expenses Fetches a list of all logged expenses and receipts. ### list_invoices Retrieves an overview of every invoice created in your system. ### list_parties Lists the entire roster of customers and suppliers you've set up. ### list_products Provides a list of all services or goods you sell. ## Prompt Examples **Prompt:** ``` List all active invoices. ``` **Response:** ``` I've retrieved your invoices. You have 5 recent invoices, including 'INV-2024-001' (Status: Paid) and 'INV-2024-005' (Status: Draft). ``` **Prompt:** ``` Find the contact details for 'Acme Corp'. ``` **Response:** ``` I found one matching party: 'Acme Corporation' (ID: party_992). Their primary contact is John Smith, and their tax ID is BE0123456789. ``` **Prompt:** ``` Show my last 3 expenses. ``` **Response:** ``` Retrieving expenses... Your 3 most recent expenses include 'Office Supplies' (€45.50), 'Cloud Hosting' (€120.00), and 'Internet Bill' (€60.00). ``` ## Capabilities ### Generate and track invoices The system can create new bills for customers or pull up detailed records of past invoices. ### Manage client and supplier accounts You can list existing business partners, check their specific details, or set up new parties in the billing system. ### Track and review expenses The agent pulls a comprehensive list of receipts and logged expenses for easy auditing. ## Use Cases ### Client asks why their bill was delayed The agent checks the party details using get_party and cross-references that against the invoice status found by list_invoices. It then tells you exactly which payment stage caused the delay, giving you an immediate answer for your client. ### Starting month-end reconciliation The agent runs a query to pull all expenses using list_expenses. Next, it asks for a list of products and compares that against the expense categories to flag any non-standard costs before sending out reports. ### Onboarding a new vendor Instead of creating a profile in two different places, you just ask the agent to create_party. You confirm it's accurate, and the billing system is updated instantly for future payments. ## Benefits - You stop jumping between tabs. Instead of logging into your CRM, then opening your accounting software to check on outstanding bills, you ask your agent directly for the status using list_invoices. - Creating new records is simple. Need a client? Just tell your agent to create_party; no need to manually fill out forms in another system first. - Expense tracking becomes instant. Instead of downloading spreadsheets and cross-referencing receipts, you simply ask to see all expenses using list_expenses. - Auditing pays off immediately. When you need proof on an old bill, your agent can pull the exact details for a specific invoice number with get_invoice. - Build better records by ensuring every new item is backed up. Before creating an invoice, checking available products via list_products keeps your billing accurate. ## How It Works The bottom line is you talk to your accounting system like talking to a person on the phone. 1. First, subscribe to the Billit MCP and enter your unique API key and desired environment (like 'api.sandbox') in Vinkius. 2. Next, connect this MCP to any compatible AI agent—your client does the rest. 3. Finally, you simply ask your agent what you need. It uses the tools available here to pull or create the data for you. ## Frequently Asked Questions **How do I create an invoice using the create_invoice tool?** You simply tell your agent that you want to create an invoice, and it walks you through the required details like dates and line items. It handles the API call structure so you don't have to worry about JSON formatting. **Can I find out if a client already exists using list_parties?** Yes, running list_parties gives you a full roster of all your current customers and suppliers. You can then use get_party with the name or ID to deep-dive into that one account. **What if I need details about an invoice before it's paid?** Use the get_invoice tool. Just providing the specific invoice number lets your agent pull up all the billing details, including line items and payment history, without you needing to manually search through records. **Is list_expenses better than listing invoices for reconciliation?** They track different things. Use list_invoices when you need to know what money was billed out; use list_expenses when you need to see the actual receipts and costs your company incurred. **When I use get_company_info, what kind of data must be provided for authentication?** You need your Billit API Key and the correct environment (sandbox or production). You provide these credentials during the initial setup process; they are not included in the natural language prompt when you call the tool. **What should I do if a request to create_invoice fails with an error?** Review the specific error message returned by the MCP. Failures usually relate to invalid API keys, missing required fields (like tax IDs), or incorrect data formatting for a specific parameter. **Does the list_products tool include pricing and tax information?** Yes, it returns detailed product records. Each record includes the current price point and any necessary associated tax codes you need to know when generating an invoice. **How do I get full contact details after running list_parties?** First, run list_parties to find the unique Party ID. Then, pass that specific ID into the get_party tool. This retrieves the complete set of contact and tax information for that single entity. **Can I check the payment status of a specific invoice?** Yes! Use the `get_invoice` tool with the Invoice ID. Your agent will fetch the latest details and payment status (e.g., Draft, Issued, Paid). **How do I list all my customers in Billit?** Simply ask the agent to `list_parties`. It will retrieve the directory of all companies and persons registered as customers or suppliers in your account. **Can I see recent expenses or receipts?** Yes. Use the `list_expenses` tool to retrieve a list of all incoming invoices and receipts recorded in your Billit account.