Billbee FAQs

Question 1

Is BillbeeMcpServer an official Billbee product?

Accepted Answer

No, BillbeeMcpServer is an independent, private project. It is not an official Billbee product and is not affiliated with Billbee GmbH in any way. Users should be aware it is used at their own risk.

Question 2

How does BillbeeMcpServer handle API rate limiting and errors?

Accepted Answer

It proactively enforces Billbee's 10 requests/second limit per API key + user using a token bucket. Additionally, it features automatic retry logic with exponential backoff for HTTP 429 (Too Many Requests) and 5xx errors, respecting the 'Retry-After' header.

Question 3

What types of Billbee operations can be automated with these tools?

Accepted Answer

The server provides 69 tools covering a wide range of Billbee functionalities including managing orders (create, update, ship, invoice), products (create, update, stock management, images), customers (create, update, addresses), shipments, events, search, and API usage statistics. This allows comprehensive e-commerce workflow automation.

Question 4

What is BillbeeMcpServer and its primary purpose?

Accepted Answer

BillbeeMcpServer is an independent C# server that exposes the entire Billbee REST API as 69 distinct Model Context Protocol (MCP) tools. Its primary purpose is to enable AI assistants like Claude Desktop, VS Code Copilot, and Cursor to natively interact with your Billbee e-commerce data and automate tasks.

Question 5

How are Billbee credentials securely managed by the server?

Accepted Answer

Credentials are never hardcoded. The server supports secure handling via environment variables for production deployments or .NET User Secrets for local development, ensuring your API key, username, and password are kept safe.

Billbee

Billbee

Key Features

Use Cases

Key Features

Use Cases