# Bsale MCP for AI Agents AI Agent Connect

> Bsale MCP for AI Agents. Automate your Chilean retail operations by issuing electronic tax documents, managing inventory across multiple branches, and handling client registrations through your AI agent. It turns complex POS tasks into simple conversations.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_wz9vkSqwH10g0rAVG4g1Va0JmDMZXpskGsSb5o1F/ai-agent-connect
- **Tags:** cloud-pos, electronic-invoicing, chilean-sii, inventory-management, retail-operations

## Description

Connect your Bsale cloud POS account to your AI agent to handle the heavy lifting of Chilean retail and invoicing. Instead of clicking through multiple menus to issue a single receipt or checking stock levels across different branches, you can just tell your agent what you need. It handles the document emission, product catalog updates, and client registrations for you. You can query your price lists or check if a specific item is available in a remote warehouse without ever opening a browser tab. This Connector is a great way to get your store operations moving, and you can find it easily in the Vinkius catalog to give your agent access to the entire catalog of tools. It turns your AI into a dedicated retail operations agent that knows your inventory, your customers, and your tax requirements.

## Tools

### list_offices
See all your registered office branches and locations.

### create_client
Register a new customer in your system. You can include their RUT and business activity for Chilean tax compliance.

### get_client
Pull all the details for a specific registered customer.

### get_document
Fetch the full details and tax breakdown of a specific tax document.

### get_product
See the complete details of a product in your catalog.

### list_clients
Browse your entire list of registered customers using pagination.

### list_document_types
See which SII-compliant document types are available for your account.

### list_documents
View a list of invoices, boletas, and credit notes with folio numbers and tax breakdowns.

### list_products
Browse your full catalog of products and services.

### list_stocks
Check current stock levels for your products across all different locations.

### list_variants
See all SKU variants for a product, including barcodes and costs.

### create_document
Issue a new electronic tax document like a boleta or factura. This sends the data directly to the Chilean SII for validation.

### create_product
Add a new item to your catalog. You can set up variants, SKUs, and specific price lists for different sales channels.

### list_payment_types
Check which payment methods your store currently accepts.

### list_price_lists
View your different pricing tiers like retail, wholesale, or distributor rates.

## Prompt Examples

**Prompt:** 
```
How many Size 40 shoes do we have at the Providencia branch?
```

**Response:** 
```
Checking stock for 'Zapatilla Running Pro' (Size 40) at the Providencia location...

**Stock Status:**
*   **Providencia:** 5 units
*   **Santiago Centro:** 12 units

There are 17 units available in total across these two branches. Would you like me to check any other sizes?
```

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

**Response:** 
```
I've registered that client for you.

**Registration Details:**
*   **Name:** Distribuidora Los Andes Ltda
*   **RUT:** 76.543.210-K
*   **Internal ID:** #2847

They are now ready for future invoices and sales documents.
```

**Prompt:** 
```
Show me the last 5 invoices issued today.
```

**Response:** 
```
Here are the last 5 tax documents issued today:

| Folio | Type | Client | Total |
| :--- | :--- | :--- | :--- |
| #4521 | Factura | Constructora Andes SpA | $128,500 CLP |
| #4522 | Boleta | Juan Perez | $15,900 CLP |
| #4523 | Factura | Tienda El Sol | $45,000 CLP |
| #4524 | Boleta | Maria Garcia | $22,100 CLP |
| #4525 | Factura | Distribuidora Los Andes | $300,000 CLP |
```

## Capabilities

### Issue electronic tax documents
Send SII-compliant boletas and facturas directly to the tax authorities.

### Manage product catalogs
Create new products with full SKU support and specific price lists.

### Track multi-branch stock
Check real-time availability for products across all office locations.

### Register new customers
Add new clients with RUT and business activity for tax compliance.

### Query store configurations
Look up payment methods and price tiers instantly.

## Use Cases

### Checking multi-branch availability
A store manager asks, 'How many Size 40 shoes do we have at the Providencia branch?' The agent uses list_stocks to give an immediate count.

### Quick tax document retrieval
An accountant asks to 'List all facturas issued last month.' The agent uses list_documents to pull a formatted list of all tax records.

### Adding complex product variants
An e-commerce owner asks to 'Add a new product with three size variants.' The agent uses create_product and list_variants to build the listing.

### Registering a new customer
A sales clerk asks to 'Register a new client with RUT 76.543.210-K.' The agent uses create_client to add them to the system instantly.

## Benefits

- Issue SII-compliant boletas and facturas instantly using create_document to save time during checkout.
- Manage complex catalogs with SKUs and pricing tiers via create_product to keep your sales channels synced.
- Track multi-branch stock levels in real-time with list_stocks to prevent overselling from different locations.
- Keep client records updated for tax compliance using create_client to ensure every sale is properly documented.
- Query your entire store setup including list_payment_types and list_price_lists without ever opening a browser tab.

## How It Works

The bottom line is you stop wrestling with a POS dashboard and start managing your store through conversation.

1. Subscribe to the Bsale MCP via Vinkius.
2. Enter your Bsale Access Token in your client settings.
3. Start asking your AI agent to handle your retail tasks.

## Frequently Asked Questions

**Can Bsale MCP issue boletas?**
Yes, it handles the emission of SII-compliant boletas and facturas. This means your agent can generate official tax documents for your customers instantly.

**Does Bsale MCP support SKUs?**
Yes, it manages product variants and SKUs. You can have different sizes, colors, and barcodes for the same product, and the agent can track them all.

**Can I check stock across branches?**
Yes, you can see stock levels for every office location. This helps you know exactly what is available in different cities without switching screens.

**Is Bsale MCP for Chilean businesses?**
Yes, it's built specifically for the Chilean retail market. It handles local requirements like RUT registration and SII-compliant document types.

**Can I register clients?**
Yes, you can register new customers with their RUT and business activity. This keeps your records organized and ready for tax reporting.

**Can I manage different price lists?**
Yes, you can query different pricing tiers like wholesale or retail. This makes it easy to check prices for different customer types.

**Can my AI agent issue a SII-compliant electronic invoice (factura electrónica) directly?**
Yes! Use the `create_document` tool with the appropriate document type ID (factura, boleta, etc.), office ID, and line item details. Bsale automatically validates and transmits the document to Chile's SII for electronic stamping.

**How can I check the stock level of a specific product variant across all my stores?**
Use the `list_stocks` tool with the variant ID as a filter. It will return the current available quantity for that SKU across every office branch configured in your Bsale account, giving you instant cross-store visibility.

**Can I register a new client with their RUT for tax compliance before issuing an invoice?**
Absolutely. Use the `create_client` tool with the client's name, RUT (in the code field), and business activity (giro). Once created, you can immediately reference their client ID when issuing documents through the `create_document` tool.