For AI assistants and the people who build them
Belline Connect: how an AI assistant reaches a business
An AI assistant acting for a customer can find a business, read what it offers, ask its own AI receptionist a question, and send a request. It is a thin layer over the booking engine and the facts Belle already answers from, not a second receptionist.
Addresses
- Remote MCP server (Streamable HTTP, stateless JSON):
https://app.belline.ai/api/connect/mcp - OpenAPI document for the web API: https://app.belline.ai/api/connect/v1/openapi.json
The tools
9 tools, read from the server itself.
search_businesses: Find local businesses that let AI assistants book through Belline.get_business_profile: One business: what it does, hours, languages, whether it books a real diary or confirms every request itself, how long it has to answer, and its services with price ranges, callout fee and emergency surcharge where the owner set them.get_availability: Free times for a business, from its own booking engine.ask_business: Asks a business's own receptionist (Belle) a question and returns her answer: opening hours, emergencies, call-out costs, areas served.book_slot: Books a real appointment in the business's diary, with no owner answer in between.create_inquiry: Sends a booking request to a business for a person.get_inquiry_status: Returns where an inquiry stands: received, proposed (the field 'proposed' holds the business's suggested time), accepted ('message' holds the visit time or note the business gave), declined ('message' may hold the reason), cancelled or expired.accept_proposal: Accepts the other time the business suggested.cancel_inquiry: Withdraw an inquiry the person no longer wants.
What it refuses
- No promised bookings. A request is something the owner answers. Only where the owner has switched on direct booking, and Belline can read and write the business's calendar (its own diary or a connected Google calendar), can an assistant book a time that was returned as free. The booking is written into that calendar.
- No bigger budget than a person has. A question put to a business's Belle goes through the same limits as its website chat, and callers are rate limited.
- Only opted-in businesses. A business that has not switched it on is not listed.
- No invented times. Free times come only from a calendar Belline can read, with what the calendar already shows busy taken out. For a business that confirms every request, or has no calendar connected, an assistant sees opening hours or a request, and the answer says which.
- Every refusal says what to do next. Errors come back as an error and a fix.
What the owner sees
Every request arrives in the owner's Inbox with its source. A question put to Belle appears as a conversation, marked as an assistant asking for a customer.
How we connected each one
These are the clicks we used on 17 November 2026. The menu names are the assistants' own and change, so treat them as a guide. Use the MCP address above.
- Claude: Add it as a custom connector with the MCP address, no authentication.
- ChatGPT: Plugins, Add, Add custom MCP server. Enter the MCP address and choose No authentication.
- Mistral Le Chat: Connectors, New connector, Add custom connector. Give it a name without spaces and enter the MCP address.
- Grok: Connectors, Add a custom connector. Enter a name and the MCP address, and no headers.
What has been tested
On 17 November 2026 we connected Claude, ChatGPT, Mistral Le Chat and Grok to a demo business of ours. Each found the business, asked Belle questions, sent a request and read its status. Claude followed a request until the owner accepted it. ChatGPT and Mistral Le Chat sent it after the person approved it; Grok sent it without asking the person first, which is how Grok behaves, and the owner still answers every request. That was our own test, not customer traffic. Nothing has been tested with other assistants.
Not the editor package
The @bellineai/mcp-server package runs on your computer and installs Belle on a website from an editor. Connect is the one for an assistant acting for a customer.
Common questions
Does an assistant book an appointment straight away?
Not unless the owner has switched on direct booking and Belline can read and write the business's calendar: its own diary or a connected Google calendar. Then the assistant books a time that was returned as free, and the booking goes into that calendar. Otherwise it sends a request, the owner answers it with a time or a reason, and nothing is booked until the owner does.
Which assistants can use it?
An assistant that can use a remote MCP server or a web API. We have run it with Claude, as a custom connector, and with ChatGPT, Mistral Le Chat and Grok, all on a demo business of ours. We have not tested other assistants and make no claim about them.
Does every business appear?
No. Only businesses whose owner switched it on are listed, and the owner can switch it off.
Is there traffic from assistants today?
We do not claim any. This is a door that is open for assistants to use, not a source of customers we can promise.