# Bsale MCP by usefulapi (io.usefulapi/bsale): tool descriptions scored

- tools/list taken: 2026-11-02 (UTC)
- From: [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.usefulapi%2Fbsale/versions/latest)
- Connected to: https://bsale.usefulapi.io/mcp
- Homepage: https://usefulapi.io/bsale/
- Repository: https://github.com/m190/usefulapi-mcp
- Scoring rules: v2
- Tools: 25
- Average: 41.4 / 100 (Cloudy)
- Near-identical pairs: 0

This page shows how Bsale MCP by usefulapi (io.usefulapi/bsale)'s tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

## Across the server

No server-wide issues.

## Tools

- `bsale_get_client`: 29 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: client_id, expand.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: client_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_get_product`: 29 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: product_id, expand.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: product_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_get_variant`: 29 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: variant_id, expand.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: variant_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_list_stocks`: 35 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: office_id, variant_id, barcode, expand.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `bsale_user_sales_summary`: 36 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: user_id.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `bsale_list_price_lists`: 37 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: coin_id, expand.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `bsale_update_client`: 37 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: client_id, first_name, last_name, company, email, phone, address, city, note.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: client_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_create_client`: 38 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: first_name, last_name, company, email, phone, address, city, note.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `bsale_list_price_list_details`: 38 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: price_list_id, variant_id, barcode, expand.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: price_list_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_list_users`: 38 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: office_id, expand.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `bsale_client_unpaid_documents`: 39 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: client_id.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `bsale_list_products`: 39 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: product_type_id, expand.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `bsale_get_document`: 40 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: expand.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: document_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_list_variants`: 41 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: barcode, product_id, expand.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `bsale_create_payment`: 42 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Major: Arguments without a description: document_id, payment_type_id, amount.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: document_id, payment_type_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_list_clients`: 43 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: first_name, last_name, email, expand.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `bsale_list_payments`: 43 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: document_id, expand.
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.
- `bsale_update_price`: 45 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: price_list_id.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: price_list_id, detail_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_list_offices`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `bsale_list_payment_types`: 47 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `bsale_list_document_types`: 48 / 100
  - Minor: Arguments without a description: code_sii.
  - Minor: No `required` list, so every argument is optional.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
- `bsale_list_returns`: 49 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: expand.
  - Minor: No `required` list, so every argument is optional.
- `bsale_create_stock_reception`: 51 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: note, details, details[].variant_id, details[].barcode, details[].quantity.
  - Minor: The description mentions none of its 3 or more arguments.
  - Minor: Says nothing about what it returns.
  - Minor: Required identifiers whose description does not say where the value comes from: office_id. Name the tool or the place that returns it, or models look it up first.
- `bsale_list_documents`: 57 / 100
  - Major: Says nothing about when to use it, or when not to.
  - Minor: Arguments without a description: client_id, expand.
  - Minor: No `required` list, so every argument is optional.
- `bsale_sales_summary`: 59 / 100
  - Minor: No `required` list, so every argument is optional.
  - Minor: Says nothing about what it returns.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

[All scored servers](https://forecall.dev/en/servers)