Developer · AI
What is the Billnado MCP server?
Overview of the Billnado MCP server for visual chatbots, including tools, authentication and administrations.
Updated on August 23, 2026
The Billnado MCP server (Model Context Protocol) gives compatible AI clients controlled access to Billnado tools and product documentation. Users can ask for information about administrations, relations and licenses in natural language. The AI client selects the appropriate tool for the question, while the server remains responsible for authentication and access control.
This documentation covers visual chatbots only. AI coding tools, CLI clients and IDE extensions are outside its scope.
Connection details
| Item | Value |
|---|---|
| Transport | Streamable HTTP |
| Primary endpoint | https://mcp.billnado.be/mcp |
| Alternative endpoint | https://mcp.facturatie-systeem.be/mcp |
| Authentication | OAuth 2.0 with PKCE |
| Tool documentation | mcp.billnado.be/documentation |
| Health check | mcp.billnado.be/health |
Use the primary endpoint for new connections whenever possible. The alternative endpoint provides the same server under the Facturatie Systeem domain.
The server publishes OAuth Protected Resource Metadata. Clients that support OAuth discovery and Dynamic Client Registration can therefore start the sign-in flow automatically. Sign in with your regular Billnado account. Never share a password, access token or refresh token in a prompt or configuration file.
Available capabilities
The current tools and their input and output fields are always listed in the live tool documentation. At a high level, the server provides:
- Administrations: search accessible administrations, retrieve the active administration and explicitly connect through direct, accountant or support access.
- Relations: search customers, suppliers and prospects and retrieve the complete details of one relation.
- Licenses: retrieve the active license and search historical, current or future licenses.
- Documentation: list available languages, search Billnado documentation and retrieve a complete Markdown article.
Almost all tools are read-only. subscriber_connect is the exception: after an explicit user request, this idempotent tool can create the existing accountant or support connection required to use an administration.
Working with administrations
Without an additional header, Billnado uses the signed-in account's default administration, or otherwise its first accessible administration.
An AI client normally follows these steps to use another administration:
- Call
subscribers_listto find the administration and its available access route. - Call
subscriber_connectonly when the user explicitly asks to connect to that administration. - Send the returned value as the
SubscriberIdHTTP header on subsequent MCP requests.
An MCP tool cannot modify the client's transport configuration. If the client cannot change headers during a session, add SubscriberId to the client configuration and reconnect. Only use an ID returned by subscribers_list for the signed-in account; inaccessible administrations return an error.
Guidelines for visual chatbots
- Search before retrieving details: for example, use
relations_searchbeforerelations_getanddocumentation_searchbeforedocumentation_get. - Ask the user to confirm the administration when more than one result is possible.
- Treat tool results as financial and personal data. Include only necessary information in prompts, logs and answers.
- Build integrations around MCP tool names and structured results, not by scraping the public documentation page.
- Recheck tool annotations and parameters when the server changes; the live tool documentation is generated from the same registered tools.
Updates and stored snapshots
Visual chatbots such as ChatGPT may store a snapshot of the available MCP tools and their input fields when they connect. Whenever the MCP tools change, also update the live tool documentation, the relevant chatbot connector and this documentation. Then refresh or reconnect the connector and start a new conversation if necessary so the chatbot loads the current tools.
Example questions
- “Find customer Acme and show its VAT number and primary email address.”
- “Which administrations can I access?”
- “Show the active license and current usage limits.”
- “Search the English Billnado documentation for how to access the API.”
Choose the installation guide for your client: