Bsale MCP by usefulapi

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

Tool	Type	What it does
bsale_list_documents	read	List documents (sales)
bsale_get_document	read	Get document
bsale_sales_summary	read	Sales summary
bsale_list_returns	read	List returns
bsale_list_document_types	read	List document types
bsale_list_clients	read	List clients
bsale_get_client	read	Get client
bsale_client_unpaid_documents	read	Client unpaid documents
bsale_list_products	read	List products
bsale_get_product	read	Get product
bsale_list_variants	read	List variants (SKUs)
bsale_get_variant	read	Get variant
bsale_list_stocks	read	List stock levels
bsale_list_price_lists	read	List price lists
bsale_list_price_list_details	read	List price list prices
bsale_list_payments	read	List payments
bsale_list_payment_types	read	List payment types
bsale_list_offices	read	List offices (branches)
bsale_list_users	read	List users (sellers)
bsale_user_sales_summary	read	Sales by seller
bsale_create_client	write	Create client
bsale_update_client	write	Update client
bsale_update_price	write	Update price list price
bsale_create_stock_reception	write	Receive stock
bsale_create_payment	write	Record payment
bsale_usage_status	meta	Usage status (free-tier meter)
bsale_request_feature	meta	Request a missing feature
bsale_upgrade	meta	Upgrade to Pro or Pro+
bsale_cancel_subscription	meta	Cancel 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

Plan	Price	Limit
Free	$0	50 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 [email protected].

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 [email protected].

License

MIT