# Bling ERP MCP for AI Agents MCP > Bling ERP connects your AI agent directly to Bling's cloud-based business management system. Manage inventory counts, track accounts payable and receivable, generate complex Brazilian tax invoices (NF-e), and process entire sales order lifecycles—all through natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** inventory-management, order-processing, tax-compliance, back-office, erp-integration, supply-chain ## Description This MCP lets you talk to your e-commerce back office like it’s a coworker sitting next to you. You don't need to navigate 15 different screens just to check if a product has stock or who owes us money. Instead, you simply ask your agent questions about contacts, products, orders, and finances. The system handles the complexity of Brazilian tax law for you. Need an invoice? Ask it to query SEFAZ endpoints for issued Product Invoices (NF-e), Consumer Invoices (NFC-e), or Service Invoices (NFS-e). It pulls records from your general ledger, letting you instantly analyze accounts payable and receivable balances using the available tools. Because this connection is managed through Vinkius, you connect once to access Bling ERP's entire operational logic—from listing incoming sales orders to mapping supplier payments. It’s about getting accurate data quickly, without ever having to log into a dashboard or copy-paste an SKU. ## Tools ### listar_contatos Retrieves a list of all registered contacts, including clients, suppliers, and carriers. ### consultar_contato Gets the complete record details for a specific contact ID. ### incluir_contato Registers a new business contact (client or supplier) into Bling ERP. ### listar_produtos Provides an exhaustive list of all products and services currently set up in the system. ### consultar_produto Looks up detailed information about a product using its specific ID. ### incluir_produto Adds a brand new product listing to the Bling catalog. ### categorias_produtos Lists all available product categories used for organization and reporting. ### listar_pedidos_venda Retrieves a list of all recorded sales orders from the system. ### consultar_pedido Gets full details for one specific sales order, including line items and payment status. ### listar_pedidos_compra Lists all purchase orders that have been sent to suppliers. ### listar_nfe Retrieves a list of issued electronic product tax invoices (NF-e). ### consultar_nfe Gets the full details, items, and status for one specific NF-e. ### listar_nfce Lists consumer electronic tax invoices (NFC-e), typically used for cash register receipts. ### listar_nfse Retrieves a list of service tax invoices (NFS-e). ### contas_receber Lists all outstanding accounts receivable, including payments due via Boletos or PIX. ### contas_pagar Lists current accounts payable obligations owed to various vendors and for operational expenses. ### categorias_financeiras Displays the list of financial account categories (the chart of accounts). ### listar_depositos Lists all configured warehouses or stock locations for inventory management. ## Prompt Examples **Prompt:** ``` Check on my outstanding bills for suppliers this month. ``` **Response:** ``` **Accounts Payable Summary** We currently have 3 pending payments: * **Vendor ID 5541 (Supplier X):** R$400.00 due Friday. * **Vendor ID 7892 (Distributor Y):** R$1,200.00 due next Monday. * **Operational Expense:** R$350.00 for utilities, due end of week. Total outstanding: **R$1,950.00**. You can use this data to plan your bank transfers. ``` **Prompt:** ``` List all product details and their current stock count. ``` **Response:** ``` **Product Inventory Snapshot** | SKU | Name | Category | Stock Location | Quantity | | :--- | :--- | :--- | :--- | :--- | | 991 | Nike Running Shoes | Footwear | Warehouse A | 45 units | | 992 | Wireless Mouse | Electronics | Warehouse B | 120 units | | ABC-300 | Office Chair Elite | Furniture | Main Depot | 8 units | Need more details on a specific product? Just ask for its ID, and I'll retrieve the full description. ``` **Prompt:** ``` What sales orders were placed last week that haven't been taxed yet? ``` **Response:** ``` **Pending Tax Invoice Report (Last 7 Days)** * **Order ID #445566:** Status: Pending NF-e. Requires action. * **Order ID #445590:** Status: Pending NFS-e. Service invoice needed. * **Order ID #445612:** Status: Complete, but NFC-e missing. Please check SEFAZ record 3522-... for the final receipt. ``` ## Capabilities ### Manage Suppliers and Clients List, search, and create records for all your contacts—whether they are suppliers, clients, or shipping carriers. ### Monitor Product Catalog Data Get a full list of every product and service you sell, along with detailed categories used across the business. ### Process Order Flow Review incoming sales orders or check on outstanding purchase orders to suppliers, linking them directly to inventory levels. ### Generate Tax Documentation Query and monitor the status of all required Brazilian tax invoices (NF-e, NFC-e, NFS-e) against SEFAZ legal standards. ### Analyze Financial Ledgers Pull aggregated financial reports to analyze accounts payable, outstanding receivables, and mapped general ledger groupings. ## Use Cases ### Checking Inventory Before Sale A logistics coordinator needs to know if they have enough stock before confirming a large shipment. They ask the agent, 'How much of SKU 991 do we have in Warehouse A?' The agent uses listar_depositos and consultar_produto to give an immediate, accurate count. ### Closing Out Monthly Accounts A financial manager needs to know which vendor bills are due this week. They ask the agent about 'pending bills for vendors,' prompting a check of contas_pagar and providing a clear list of amounts owed. ### Handling Returns and Tax Paperwork A sales rep handles a returned item and needs to verify if the corresponding tax invoice was correctly issued. The agent checks listing NFC-e or listar_nfe, confirming the correct legal documentation was generated for the refund. ### Onboarding New Suppliers The purchasing team hires a new vendor and needs to set them up in the system. They use incluir_contato, providing all the required details, so the vendor is immediately ready to receive purchase orders via listar_pedidos_compra. ## Benefits - Instantly check order status. Instead of listing all sales orders manually, you can ask your agent to find 'all pending shipments for the Northeast region,' using listar_pedidos_venda. - Streamline tax compliance checks. You never have to guess which invoice type is needed; simply asking the agent about 'product invoices issued yesterday' uses listar_nfe and gives you immediate, accurate data. - Reconcile finances without leaving your chat window. The tool lets you query contas_receber or contas_pagar directly, giving you a real-time view of cash flow based on outstanding obligations. - Maintain product accuracy across channels. By listing products using listar_produtos and checking categories using categorias_produtos, you ensure that every new item is correctly mapped before going live. - Streamline client data collection. Need to talk to a supplier? You can use listar_contatos or consultar_contato to verify their current address and tax ID instantly. ## How It Works The bottom line is that you treat complex ERP tasks like simple conversations with your AI client. 1. First, subscribe to this MCP on Vinkius and provide your Bling Access Token. 2. Next, simply ask your AI agent (e.g., 'Check the outstanding accounts payable for Acme Corp.') 3. The agent interprets the request, calls the appropriate function within this MCP, and delivers a clean, conversational answer. ## Frequently Asked Questions **How can I use Bling ERP MCP to manage my inventory levels?** You can ask your agent about product stock and warehouse locations at any time. It checks current listings, tells you what's in which specific depot, and helps verify product details before a sale. **Does Bling ERP MCP help with tax invoices for different types of goods?** Yes, it handles all major Brazilian formats. You can query the system for electronic product invoices (NF-e), consumer receipts (NFC-e), and service invoices (NFS-e) to ensure you always have the correct legal documentation. **What if I want to know who owes me money right now?** You can ask about your outstanding receivables. The MCP checks accounts receivable, giving you a clear list of invoices and amounts due from clients across different payment methods like PIX or Boleto. **Can Bling ERP MCP help me set up new contacts?** Absolutely. You can tell the agent to create a new supplier or client, providing all the necessary information to register them into your system immediately using the include_contato tool. **Does this MCP only handle sales orders, or also purchases?** It covers the full cycle. You can list and review both incoming sales orders (from customers) and outgoing purchase orders (to suppliers), keeping your entire supply chain visible to your agent. **Is this MCP suitable for small businesses that don't have a dedicated accounting team?** Yes. It takes the most complex tasks—like reconciling general ledgers or checking tax compliance—and puts them into simple, conversational commands, making advanced ERP functions accessible to anyone.