What is the Billnado MCP server?

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, retrieve a complete Markdown article and resolve page help from an application route.

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:

1. Call subscribers_list to find the administration and its available access route.
2. Call subscriber_connect only when the user explicitly asks to connect to that administration.
3. Send the returned value as the SubscriberId HTTP 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_search before relations_get and documentation_search before documentation_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.

Refresh outdated tools

If a chatbot does not recognise a new or changed Billnado capability, refresh or reconnect the connector and start a new conversation if necessary. This makes the chatbot load the current tools instead of the snapshot stored when it connected.

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:

• Connect Billnado to ChatGPT
• Connect Billnado to Claude
• Connect Billnado to Grok
• Connect Billnado to Microsoft 365 Copilot