# Bsale MCP MCP

> Bsale provides full control over Chilean Point of Sale (POS) operations via natural conversation. Use this MCP to issue legally compliant electronic invoices, manage your entire product catalog with variants, and check real-time inventory across multiple physical branches—all without leaving your AI chat window.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** cloud-pos, electronic-invoicing, chilean-sii, inventory-management, retail-operations

## Description

Need to handle retail transactions or manage a warehouse in Chile? This connector links your Bsale cloud POS account directly to your agent. You can perform core business functions like issuing SII-compliant electronic invoices, managing client records using their RUT number, and ensuring product data is accurate down to the SKU level. It’s built for those who need full control over Chilean tax compliance and inventory counts without navigating multiple physical terminals or web screens. Your AI agent becomes your dedicated operations assistant. You'll find this MCP cataloged in Vinkius, making it simple to connect Bsale with any compatible client like Claude or Cursor so you can manage everything through plain conversation.

## Tools

### create_client
Registers a new client record, collecting necessary tax details like the RUT and business activity (giro).

### create_document
Issues a new electronic tax document type, automatically sending it to the Chilean SII for validation.

### create_product
Adds an entirely new product into the catalog, ready for use in future invoices and stock tracking.

### get_client
Retrieves all known details for a specific client ID or RUT number.

### get_document
Pulls up the complete record and details of any specified tax document.

### get_product
Fetches full information, including pricing rules, for one product by its ID.

### list_clients
Retrieves a paginated list of all clients currently registered in the system.

### list_document_types
Lists all available types of tax documents that comply with SII regulations.

### list_documents
Returns a paginated summary of historical sales records, including invoices and receipts.

### list_offices
Shows you every physical office branch location connected to the Bsale account.

### list_payment_types
Provides an inventory of all accepted payment methods (e.g., credit card, cash).

### list_price_lists
Lists every configured pricing structure, useful for wholesale or retail rate management.

### list_products
Browses and retrieves a paginated list of all products and services in your catalog.

### list_stocks
Checks the available quantity count for products across every office branch location.

### list_variants
Lists all specific Stock Keeping Unit (SKU) variations, including costs and barcodes, for a given product.

## Prompt Examples

**Prompt:** 
```
Show me the last 10 invoices issued in my Bsale account.
```

**Response:** 
```
I found 10 recent documents. Notable entries include Factura Electrónica #4521 for $128,500 CLP (client: Constructora Andes SpA), Boleta #8903 for $15,900 CLP, and Nota de Crédito #102 voiding document #4518. Would you like the full breakdown of any specific document?
```

**Prompt:** 
```
Check stock levels for all variants of product ID 1542.
```

**Response:** 
```
Product 1542 'Zapatilla Running Pro' has 3 variants: Size 40 (SKU: ZRP-40) — 12 units at Santiago Centro, 5 at Providencia. Size 42 (SKU: ZRP-42) — 8 units at Santiago Centro, 0 at Providencia (out of stock!). Size 44 (SKU: ZRP-44) — 3 units at both locations. Should I create a restocking alert?
```

**Prompt:** 
```
Register a new client 'Distribuidora Los Andes Ltda' with RUT 76.543.210-K.
```

**Response:** 
```
Client created successfully! 'Distribuidora Los Andes Ltda' has been registered with RUT 76.543.210-K and assigned internal ID #2847. You can now use this client ID when issuing facturas electrónicas or boletas. Would you like to issue an invoice for them right now?
```

## Capabilities

### Issue electronic tax documents
Automatically generates and sends legally required invoices, receipts, and credit notes to the Chilean SII.

### Manage product catalog details
Creates or updates products, including specific variants (SKUs), pricing tiers, and web descriptions in the central catalog.

### Check stock levels across multiple offices
Retrieves real-time inventory counts for specific product variations at every registered office location.

### Register and verify clients
Searches or adds new customer records, ensuring key tax compliance details like the RUT are captured.

### Query system configuration data
Retrieves instant information on things like available payment methods, price lists, and office locations.

## Use Cases

### End-of-day reconciliation for an accountant
The accountant needs to reconcile sales from last week. They ask their agent, 'Show me all invoices and receipts between Monday and Friday.' The agent uses `list_documents` and then can drill down with `get_document` to pull full details needed for month-end reporting.

### Restocking an item across branches
The manager notices stock is low on a specific product. They ask the agent to check inventory, triggering `list_stocks`. The agent reports the shortage at three different locations, allowing the manager to schedule pickups from those exact spots.

### Onboarding a new large client
A major distributor walks in. The associate uses the agent to register them with `create_client`, capturing their RUT and business activity. They can then immediately issue an invoice for this new account using `create_document`.

### Updating product pricing after a sale
The e-commerce team needs to update the price on 50 different variants. The agent uses `list_products` and then specific calls are made to adjust prices, ensuring all associated SKUs reflect the new rate.

## Benefits

- Issue official tax documents instantly. You don't need to switch tabs; your agent handles the complex process of using `create_document` and sending it through SII.
- Manage product data centrally. Use `list_variants` or `get_product` to ensure every SKU has accurate pricing and stock tracking across multiple locations.
- Real-time inventory visibility. Instead of guessing, you can call `list_stocks` to see exactly how many units are available at the Santiago Centro branch right now.
- Efficient client handling. Use `create_client` or `get_client` to register new customers and ensure all required tax details for compliance are captured immediately.
- Know your system structure. Tools like `list_offices` and `list_payment_types` give you a quick overview of the entire operational setup.

## How It Works

The bottom line is that you just talk to your AI client; it handles the connection and executes the Bsale actions for you.

1. First, subscribe to the Bsale MCP in Vinkius and provide your Bsale Access Token.
2. Next, select any compatible client—like Cursor or Claude—and authorize it to use this connector.
3. Finally, start a conversation with your agent. You can then ask things like, 'Issue a boleta for Client X' or 'Show me stock levels for Product Y'.

## Frequently Asked Questions

**How do I use the bsale create_document tool?**
You don't call it directly; you tell your agent to 'Issue a boleta for this product.' The agent handles passing the required document type ID and line items through `create_document` automatically.

**Can I use list_stocks to check multiple products?**
Yes. You can ask the agent to check stock levels across several different product IDs in a single query, getting availability per SKU and location.

**Does bsale create_client require tax details?**
Yep. For Chilean compliance, you need to provide the RUT and business activity (giro) when telling your agent to run `create_client`. This makes the client usable for invoicing.

**What is the difference between list_products and list_variants?**
`list_products` gives you the main item name and general details. You must use `list_variants` next time you need to know about specific size, color, or SKU variations that impact pricing or stock.

**If I use the create_document tool and the Chilean SII rejects it, how do I find out why?**
The tool returns a specific error code or detailed message from the Servicio de Impuestos Internos (SII). This tells you exactly what needs fixing—like an invalid client RUT or a missing mandatory data point.

**Does list_documents have limitations on how many invoices I can retrieve at once?**
Yes, the tool supports pagination using limit and offset parameters. If you need more records than the default page size, just adjust the offset parameter to continue fetching historical document data.

**What information does list_offices require to pull my branch locations?**
The tool only requires your established Bsale Access Token for authentication. It automatically pulls all office branches linked under that token; no extra credentials are needed.

**Before I use the create_document tool, how can I check all valid document types using list_document_types?**
Running `list_document_types` provides a complete inventory of available SII document identifiers. This ensures you select the correct and currently authorized type before attempting to issue any tax document.