Find local businesses, read services and times, ask their AI receptionist, send booking requests.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Accepts the other time the business suggested. It works only while the inquiry's status is 'proposed'. The suggested time becomes the message and the status becomes accepted.
The id create_inquiry returned.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http belline-connect https://app.belline.ai/api/connect/mcp
Accepts the other time the business suggested. It works only while the inquiry's status is 'proposed'. The suggested time becomes the message and the status becomes accepted.
| Argument | Type | Description |
|---|---|---|
| id* | string | The id create_inquiry returned. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The id create_inquiry returned."
}
}
}Asks a business's own receptionist (Belle) a question and returns her answer: opening hours, emergencies, call-out costs, areas served. She answers only from what the business has told her and says when she does not know, as she does for any customer. The answer carries a conversation_id that continues the same conversation. If the person wants to go ahead she may take their details and pass the request to the business; that is not a booking. The first message tells her an AI assistant is asking for a customer.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Business slug. |
| message* | string | The question, in plain language, up to about 600 characters. |
| agent_name* | string | Which assistant is asking, for example Claude. |
| conversation_id | string | From an earlier answer, to continue the same conversation. Leave out to start a new one. |
{
"type": "object",
"required": [
"slug",
"agent_name",
"message"
],
"properties": {
"slug": {
"type": "string",
"description": "Business slug."
},
"message": {
"type": "string",
"description": "The question, in plain language, up to about 600 characters."
},
"agent_name": {
"type": "string",
"description": "Which assistant is asking, for example Claude."
},
"conversation_id": {
"type": "string",
"description": "From an earlier answer, to continue the same conversation. Leave out to start a new one."
}
}
}Books a real appointment in the business's diary, with no owner answer in between. It works only for a business whose profile has instantBooking true and for a time that get_availability returned. Returns the booking reference and a link to change or cancel it.
| Argument | Type | Description |
|---|---|---|
| date* | string | The day, YYYY-MM-DD, from get_availability. |
| slug* | string | Business slug. |
| notes | string | Anything the business should know. Optional. |
| start* | string | The start time, HH:MM, from get_availability. |
| agent_name* | string | Which assistant is booking, for example Claude. |
| request_id | string | Your id for this booking, so a retry does not book twice. |
| service_id* | string | A service id from get_business_profile. |
| customer_name* | string | The person's name. |
| customer_email |
Withdraw an inquiry the person no longer wants. Works until the business has declined it or it expired; an accepted one can still be cancelled.
| Argument | Type | Description |
|---|---|---|
| id* | string | The id create_inquiry returned. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The id create_inquiry returned."
}
}
}Sends a booking request to a business for a person. It does not book anything: the business answers (accepted, proposed another time, or declined) within the time stated in get_business_profile, and the answer is read with get_inquiry_status. A repeated request_id returns the same inquiry.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Business slug. |
| address | string | Where, if the work is at their address. |
| urgency | string | |
| preferred* | string | When they would like it, in words: 'Thursday 14:00 to 16:00'. |
| agent_name* | string | Which assistant is asking, for example Claude. The business sees this as your own word. |
| request_id | string | Your id for this request, so a retry does not make a second inquiry. |
| service_id | string | A service id from get_business_profile. Optional if you describe the job. |
| description | string | What needs doing, in the person's words. |
| customer_name |
Free times for a business, from its own booking engine. Answers one of three ways: 'slots' (real free times), 'windows' (the hours the business is open, for a business with no diary of people; NOT free times, the owner confirms the visit time) or 'request' (the business confirms every request itself). Never invents a time. At most 14 days.
| Argument | Type | Description |
|---|---|---|
| to | string | Last date, YYYY-MM-DD. Optional, defaults to a week on. |
| from | string | First date, YYYY-MM-DD. Optional, defaults to today. |
| slug* | string | Business slug. |
| service_id | string | A service id from get_business_profile. Optional. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"to": {
"type": "string",
"description": "Last date, YYYY-MM-DD. Optional, defaults to a week on."
},
"from": {
"type": "string",
"description": "First date, YYYY-MM-DD. Optional, defaults to today."
},
"slug": {
"type": "string",
"description": "Business slug."
},
"service_id": {
"type": "string",
"description": "A service id from get_business_profile. Optional."
}
}
}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. Prices are the owner's own figures; a range means the owner confirms the exact price once the job is seen.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The business slug from search_businesses. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The business slug from search_businesses."
}
}
}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. Carries no personal detail. Only accepted means the business agreed.
| Argument | Type | Description |
|---|---|---|
| id* | string | The id create_inquiry returned. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The id create_inquiry returned."
}
}
}Find local businesses that let AI assistants book through Belline. Matches words against the business name, trade, services and address as text; it does not search by distance. Returns each business with its services and price ranges, in its own currency. Only businesses whose owner switched this on are listed.
| Argument | Type | Description |
|---|---|---|
| q | string | Words to match, for example 'plumber Marina'. Optional. |
| lang | string | Language code the business speaks, for example de or en. Optional. |
| limit | integer | |
| trade | string | A trade key as it appears in a business result (tradeKey), for example trades. Optional; when absent, the words in q are matched on their own. |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Words to match, for example 'plumber Marina'. Optional."
},
"lang": {
"type": "string",
"description": "Language code the business speaks, for example de or en. Optional."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"trade": {
"type": "string",
"description": "A trade key as it appears in a business result (tradeKey), for example trades. Optional; when absent, the words in q are matched on their own."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.
| string |
| An email address. Phone or email is needed. |
| customer_phone | string | A phone number, with country code. Phone or email is needed. |
{
"type": "object",
"required": [
"slug",
"agent_name",
"service_id",
"date",
"start",
"customer_name"
],
"properties": {
"date": {
"type": "string",
"description": "The day, YYYY-MM-DD, from get_availability."
},
"slug": {
"type": "string",
"description": "Business slug."
},
"notes": {
"type": "string",
"description": "Anything the business should know. Optional."
},
"start": {
"type": "string",
"description": "The start time, HH:MM, from get_availability."
},
"agent_name": {
"type": "string",
"description": "Which assistant is booking, for example Claude."
},
"request_id": {
"type": "string",
"description": "Your id for this booking, so a retry does not book twice."
},
"service_id": {
"type": "string",
"description": "A service id from get_business_profile."
},
"customer_name": {
"type": "string",
"description": "The person's name."
},
"customer_email": {
"type": "string",
"description": "An email address. Phone or email is needed."
},
"customer_phone": {
"type": "string",
"description": "A phone number, with country code. Phone or email is needed."
}
}
}| string |
| The person's name. |
| customer_email | string | An email address to reach them. Phone or email is needed. |
| customer_phone | string | A phone number to reach them, with country code. Phone or email is needed. |
{
"type": "object",
"required": [
"slug",
"agent_name",
"customer_name",
"preferred"
],
"properties": {
"slug": {
"type": "string",
"description": "Business slug."
},
"address": {
"type": "string",
"description": "Where, if the work is at their address."
},
"urgency": {
"enum": [
"emergency",
"this_week",
"flexible"
],
"type": "string"
},
"preferred": {
"type": "string",
"description": "When they would like it, in words: 'Thursday 14:00 to 16:00'."
},
"agent_name": {
"type": "string",
"description": "Which assistant is asking, for example Claude. The business sees this as your own word."
},
"request_id": {
"type": "string",
"description": "Your id for this request, so a retry does not make a second inquiry."
},
"service_id": {
"type": "string",
"description": "A service id from get_business_profile. Optional if you describe the job."
},
"description": {
"type": "string",
"description": "What needs doing, in the person's words."
},
"customer_name": {
"type": "string",
"description": "The person's name."
},
"customer_email": {
"type": "string",
"description": "An email address to reach them. Phone or email is needed."
},
"customer_phone": {
"type": "string",
"description": "A phone number to reach them, with country code. Phone or email is needed."
}
}
}