Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Bsale MCP by usefulapi

by m190version 1.10.1i★ 1 (Stars for the whole repo)iRuns in the cloud
Registry nameio.usefulapi/bsale

How to install

What it does

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

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Docs, sheets & office work

Install

Pick the AI app you use, then copy the settings.

Passed 4/4 checks · What you ask goes through the maker’s server (bsale.usefulapi.io) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameBsale MCP by usefulapi
    Remote MCP server URL · Addresshttps://bsale.usefulapi.io/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsBsale MCP by usefulapi

  4. Try it

    Use Bsale MCP by usefulapi and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Bsale MCP by usefulapi or shows a Bsale MCP by usefulapi tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameBsale MCP by usefulapi
    Connection · Addresshttps://bsale.usefulapi.io/mcp
  3. Pick Bsale MCP by usefulapi in a chat

    Start a new chat and pick Bsale MCP by usefulapi from your plugins before typing

  4. Try it

    Use Bsale MCP by usefulapi and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Bsale MCP by usefulapi or shows a Bsale MCP by usefulapi tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user bsale https://bsale.usefulapi.io/mcp
  3. Type /mcp in Claude Code

    You should see Bsale MCP by usefulapi listed as connected

  4. Try it

    Use Bsale MCP by usefulapi and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Bsale MCP by usefulapi or shows a Bsale MCP by usefulapi tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Bsale MCP by usefulapi and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Bsale MCP by usefulapi or shows a Bsale MCP by usefulapi tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Bsale MCP by usefulapi and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Bsale MCP by usefulapi or shows a Bsale MCP by usefulapi tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://bsale.usefulapi.io/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Bsale MCP by usefulapi💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub starsi
1 (Stars for the whole repo)
This repo holds several MCP listings; its stars count once in rankings
Downloads per weeki
Not on npm/PyPI
Verified domain
✓ usefulapi.io
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
1.10.1
Published to registryi
Nov 13, 2026
Code last changedi
Nov 13, 2026
Maker
m190
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 9, 2026. The maker wrote them, not us; we show them as plain text.

  • 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

  • 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_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_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_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_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_get_client

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

  • 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_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_get_product

    One product by id; expand=[product_type] adds the type. GET /v1/products/{id}.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_get_variant

    One variant (SKU) by id; expand=[product] embeds the product. GET /v1/variants/{id}.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_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_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_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_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_offices

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

  • bsale_list_users

    List Bsale users (sellers/cashiers) with name and office. GET /v1/users.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.

  • 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_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_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 firs

  • 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 fr

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 14, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain usefulapi.io (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • – Not applicable

    Has a licence

    Not applicable: a cloud server run by the owner of usefulapi.io; you don't run code from the repo

  • ✓ Pass

    Endpoint responds

    Responded in 16 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 25 tool descriptions and found no hidden instructions to the AI

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in with Google to post

User reviews

No reviews yet

Sign in with Google to write a review

Compared with others in Docs, sheets & office worki

  • More stars than 0% of the other 3891 servers in this category
  • Published to the registry more recently than 96% of the other 3891 servers in this category
  • Basic checks equal to or better than 100% of the other 3891 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Bsale MCP by usefulapi safe?

It passed 4 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (1.10.1) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Puter MCP, XcodeBuildMCP, XcodeBuildMCP

Others in the same category

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

by HeyPuterWidely used★ 44.2KUpdated 5 months ago

Runs in the cloud✓ service owner · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by getsentryWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 4 months ago

Runs on your computer✓ service owner · xcodebuildmcp.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by cameroncookeWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 14 months ago

Runs on your computer

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Bsale MCP by usefulapi

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

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://bsale.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http bsale https://bsale.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
{

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

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Bsale credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bsale/

Tools

ToolTypeWhat it does
bsale_list_documentsreadList documents (sales)
bsale_get_documentreadGet document
bsale_sales_summaryreadSales summary
bsale_list_returnsreadList returns
bsale_list_document_typesreadList document types
bsale_list_clientsreadList clients
bsale_get_clientreadGet client
bsale_client_unpaid_documentsreadClient unpaid documents
bsale_list_productsreadList products
bsale_get_productreadGet product
bsale_list_variantsreadList variants (SKUs)
bsale_get_variantreadGet variant
bsale_list_stocksreadList stock levels
bsale_list_price_listsreadList price lists
bsale_list_price_list_detailsreadList price list prices
bsale_list_paymentsreadList payments
bsale_list_payment_typesreadList payment types
bsale_list_officesreadList offices (branches)
bsale_list_usersreadList users (sellers)
bsale_user_sales_summaryreadSales by seller
bsale_create_clientwriteCreate client
bsale_update_clientwriteUpdate client
bsale_update_pricewriteUpdate price list price
bsale_create_stock_receptionwriteReceive stock
bsale_create_paymentwriteRecord payment
bsale_usage_statusmetaUsage status (free-tier meter)
bsale_request_featuremetaRequest a missing feature
bsale_upgrademetaUpgrade to Pro or Pro+
bsale_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per Bsale company and API host)$9/mo or $90/yr (2 months free)Unlimited*

\*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to support@usefulapi.io.

Pro covers this server only. Subscribe with bsale_upgrade (it returns a Stripe Checkout link). Cancel any time with bsale_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running bsale_upgrade before then undoes the cancel. Or write to support@usefulapi.io.

License

MIT