Bsale MCP by usefulapi MCP Server

by usefulapi Your server? Claim it

answering

Bsale MCP by usefulapi is answering right now. Last checked 3 min ago. It exposes 25 tools. Last commit 1 Nov 2026.

Read Bsale products, documents and stock; manage customers, prices, receipts and payments.

Uptime history 37 hours of history

37 hours agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

210 ms

Response time

average over 24h

Stars

last commit 1 Nov 2026

What changed 4

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 31 October 2026. No other catalogue keeps this.

31 Oct a tool changed version4 times that day

and 3 more, back to 31 October 2026

Nothing serious here today

Today is the operative word: we check Bsale MCP by usefulapi every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 3 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add bsale --transport http https://bsale.usefulapi.io/mcp

Settings → Connectors → Add custom connector, then paste this address

https://bsale.usefulapi.io/mcp

~/.codex/config.toml

[mcp_servers.bsale]
url = "https://bsale.usefulapi.io/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "bsale": {
      "url": "https://bsale.usefulapi.io/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "bsale": {
      "type": "http",
      "url": "https://bsale.usefulapi.io/mcp"
    }
  }
}

Available tools 25

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

bsale

bsale_client_unpaid_documents

A client's receivables: overdue and upcoming debt, total owed, and the unpaid documents with amounts. Give client_id or client_code. GET /v1/clients/unpaid_documents.json.

bsale_create_client

WRITE: create a new customer in Bsale (it is visible to every user of the instance). Give at least a first name or a company. Bsale rejects a second client with the same tax id. POST /v1/clients.json.

bsale_create_payment

WRITE: record a payment against an issued document (normally a credit sale that is still unpaid). It changes the document's receivable balance in the books and cannot be removed through this API. Check the amount with bsale_client_unpaid_documents first and get payment_type_id from bsale_list_payment_types. POST /v1/payments.json.

bsale_create_stock_reception

WRITE: record a stock reception (ingreso de stock) that ADDS quantities to an office's inventory. Each line names the variant by id, SKU code or barcode, with quantity and unit cost. It changes stock levels and cost; Bsale has no undo through this API, so confirm the numbers first. POST /v1/stocks/receptions.json.

bsale_get_client

One customer by id. Use expand=[contacts,attributes,addresses] to include contacts and extra attributes. GET /v1/clients/{id}.json.

bsale_get_document

One document by id with its amounts, dates, state and links. Use expand=[details,payments,client,office,document_type,references,sellers] to include line items, payments and related records. GET /v1/documents/{id}.json.

bsale_get_product

One product by id; expand=[product_type] adds the type. GET /v1/products/{id}.json.

bsale_get_variant

One variant (SKU) by id; expand=[product] embeds the product. GET /v1/variants/{id}.json.

bsale_list_clients

List customers with name, tax id (code), email, phone, address, credit limit and loyalty points. Filter by tax id, name, last name or email. GET /v1/clients.json.

bsale_list_document_types

List document types (boleta, factura, nota de credito, guia de despacho...) with their id and tax (SII) code. Use the id when filtering documents. GET /v1/document_types.json.

bsale_list_documents

List issued documents (boletas, facturas, notas de credito, guias...) newest-first as Bsale returns them, with number, dates, net/tax/total amounts, state, SII status and public PDF link. Filter by emission date range, document type, client, office, folio number or SII code. Use expand (details, payments, client, office, document_type) to embed related data. GET /v1/documents.json.

bsale_list_offices

List branches (sucursales) with name, address and cost center. Use the id for stock and document filters. GET /v1/offices.json.

bsale_list_payment_types

List payment methods (cash, card, transfer, credit...) with their id. The id is needed to record a payment. GET /v1/payment_types.json.

bsale_list_payments

List payments received (amount, date, payment type, document, office, user). Filter by payment date, document id, or document tax code plus folio number. GET /v1/payments.json.

bsale_list_price_list_details

Prices in one price list: the net price (variantValue) and price with taxes per variant, plus the detail id needed to change a price. Filter by variant id, SKU code or barcode. GET /v1/price_lists/{id}/details.json.

bsale_list_price_lists

List price lists with name, currency and state. Use the id with bsale_list_price_list_details. GET /v1/price_lists.json.

bsale_list_products

List products and services (name, description, class, stock control, state). SKUs live on variants: see bsale_list_variants. GET /v1/products.json.

bsale_list_returns

List returns (devoluciones) with date, motive, amounts and the credit note issued. Use expand=[reference_document,credit_note,details] for more. GET /v1/returns.json.

bsale_list_stocks

Stock per variant and office: quantity, reserved and available. Filter by office, variant id, SKU code or barcode (for a pack give a variant filter plus office_id). expand=[variant,office] adds names. GET /v1/stocks.json.

bsale_list_users

List Bsale users (sellers/cashiers) with name and office. GET /v1/users.json.

bsale_list_variants

List product variants, the sellable SKUs: description, SKU code, barcode, stock settings and product link. Search by SKU code, barcode, description or product id. GET /v1/variants.json.

bsale_sales_summary

Totals of sales documents (net, tax, total, count) by month, document type and office for a date range; set per_document to list each document instead. Good for 'how much did we sell in September?'. GET /v1/documents/summary.json.

bsale_update_client

WRITE: change fields of an existing customer; only the fields you pass are sent. This overwrites the stored values. PUT /v1/clients/{id}.json.

bsale_update_price

WRITE: set the net price (variantValue, without taxes) of one variant in a price list. This changes what Bsale charges on new sales using that list. Get detail_id from bsale_list_price_list_details. PUT /v1/price_lists/{id}/details/{detail_id}.json.

bsale_user_sales_summary

Sales and tax subtotal per seller for a date range (default: today, UTC), or for one user. GET /v1/users/sales_summary.json.

Endpoints

URL	Transport	State	Latency	Checked
https://bsale.usefulapi.io/mcp	streamable-http	answering	178 ms	3 min ago

Alternatives to Bsale MCP by usefulapi

same job, measured the same way

EasyStore MCP by usefulapi

by usefulapi

Read EasyStore orders, products and customers; manage stock, fulfillments and customer records.

29 tools answering

Smaregi MCP by usefulapi

by usefulapi

Read Smaregi stores, products, customers, stock and transactions; manage customers, products, stock.

20 tools answering

Hiboutik MCP by usefulapi

by usefulapi

Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.

31 tools answering

KiotViet MCP by usefulapi

by usefulapi

Read KiotViet products, customers, invoices, orders and stock; create customers and orders.

29 tools answering

Rackbeat MCP by usefulapi

by usefulapi

Read Rackbeat products, location stock, sales orders and customer summaries.

7 tools answering

Fakturowo MCP by usefulapi

by usefulapi

Read invoices, clients and products in Fakturowo; create documents and update payment status.

9 tools answering

Sapo MCP by usefulapi

by usefulapi

Read Sapo store products, orders, customers and stock levels; edit order notes and stock.

20 tools answering

Bookeo MCP by usefulapi

by usefulapi

Check Bookeo availability and manage bookings, holds and customers; read payments.

21 tools answering

Bsale MCP by usefulapi — questions

Answers built from our own checks of this server.

What can Bsale MCP by usefulapi do?

It exposes 25 tools, read directly from the server on our last check. Among them: bsale_client_unpaid_documents, bsale_create_client, bsale_create_payment, bsale_create_stock_reception, bsale_get_client, bsale_get_document and 19 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Bsale MCP by usefulapi working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 210 ms. The bar chart above shows every period we have measured.

How do I connect Bsale MCP by usefulapi?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Bsale MCP by usefulapi need an API key?

No. Bsale MCP by usefulapi completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 25 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Bsale MCP by usefulapi?

It answers our handshake in 210 ms on average, which is faster than 66% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Bsale MCP by usefulapi open source?

The code is open source: it is published under the MIT licence, written in JavaScript, 1 stars on GitHub and 1 open issue. The licence covers the code in the repository, not the hosted service at bsale.usefulapi.io, which runs on its operator's own terms.