billz_mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| billz_get_products | Get list of products. Use last_updated_date to sync only changed products. Returns category_name, category_id, photos at top level. |
| billz_filter_products | Filter/search products with advanced criteria. Valid status values: 'all' | 'active' | 'inactive'. Use product_field_filters for custom field filtering (field_type: 'custom' or 'attribute'). |
| billz_get_customers | Get list of customers |
| billz_get_customer | Get detailed info for a single customer |
| billz_get_debt_stats | Get debt statistics for a customer |
| billz_get_sales | Get list of completed sales |
| billz_get_sale_detailsC | Get details of a specific sale |
| billz_search_salesC | Search sales with advanced filters (v3 endpoint) |
| billz_report_general_table | General summary report table (sales, products, customers, sellers stats) |
| billz_report_general_totalsD | General summary report totals (sums) |
| billz_report_products_table | Product sales report table |
| billz_report_customers_tableC | Customer statistics report table |
| billz_report_profit_lossD | Profit and loss report |
| billz_report_stock | Stock on hand report (inventory levels at a specific date) |
| billz_get_shopsC | Get list of shops |
| billz_get_categoriesC | Get product categories |
| billz_get_brandsC | Get list of product brands |
| billz_get_product_characteristicsC | Get product custom field definitions |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| doc-authentication--authentication | BILLZ API: Authentication |
| doc-authentication--how-to-create-integration-key | BILLZ API: How to create integration key |
| doc-methods--auxiliary--auxiliary-methods | BILLZ API: Auxiliary Methods |
| doc-methods--customers--customers | BILLZ API: Customers |
| doc-methods--imports--imports | BILLZ API: Imports |
| doc-methods--methods | BILLZ API: Methods |
| doc-methods--orders--orders | BILLZ API: Orders |
| doc-methods--products--add-edit-product-custom-field | BILLZ API: Add Edit Product Custom Field |
| doc-methods--products--filter-products | BILLZ API: Filter Products |
| doc-methods--products--get-products | BILLZ API: Get Products |
| doc-methods--promotions--promotions | BILLZ API: Promotions |
| doc-methods--reports--reports | BILLZ API: Reports |
| doc-methods--sales--certificates | BILLZ API: Certificates |
| doc-methods--sales--drafts-and-postponed | BILLZ API: Drafts and Postponed |
| doc-methods--sales--list-of-drafts | BILLZ API: List of Drafts |
| doc-methods--sales--list-of-postponed-sales | BILLZ API: List of Postponed Sales |
| doc-methods--sales--list-of-sales | BILLZ API: List of Sales |
| doc-methods--sales--sale-details | BILLZ API: Sale Details |
| doc-methods--sales--sale | BILLZ API: Sale |
| doc-methods--transfers--transfer-items | BILLZ API: Transfer Items |
| doc-methods--transfers--transfers | BILLZ API: Transfers |
| doc-readme | BILLZ API: README |
TDQS
Scored across 9 tools
Most tools target clearly distinct resources: product characteristics, sale details, sales search, reports, shops, categories, and brands. The main source of potential confusion is between billz_report_general_totals and billz_report_profit_loss, which both deal with aggregated financial figures, though their descriptions separate them reasonably.
Tool names follow a mostly consistent pattern of billz_ + action + resource: get_product_characteristics, get_sale_details, get_shops, get_categories, get_brands, search_sales, report_general_totals, report_customers_table, report_profit_loss. The minor inconsistency is the report_* prefix vs get_*/search_*, and report_customers_table is slightly awkward, but overall the pattern is readable and predictable.
Nine tools is well within the ideal range for an integration server. Each tool covers a distinct area of the Billz retail/ERP domain without feeling padded or redundant.
The server covers sales retrieval, reporting, and reference data like shops, categories, and brands. However, it lacks basic product catalog access (only product characteristics are available), and there is no way to list or fetch individual customers, even though customer reports exist. This leaves notable gaps in the apparent domain.