add_knowledge_chapter
API reference — one of six tools an AI assistant can call on an Avrosh account.
What it does
Write one NEW chapter of knowledge: a title and a body of plain text, in the operator's own words - opening hours, what is and is not offered, policies, anything a customer would phone to ask. Only write what the human actually told you; never invent a fact about the business. Call list_knowledge first: if a chapter on the subject already exists this tool refuses with its id, so you update it instead of creating a duplicate that argues with it.
This is the exact text the model reads before deciding to call.
Parameters
business_idstringrequired
The id returned by list_businesses.
titlestringrequired
The chapter heading, e.g. 'Opening hours'. Max 200 chars.
bodystringrequired
The facts as plain text, written the way the business would say them. Line breaks are kept.
Request
curl -X POST https://us.avrosh.com/mcp \
-H "Authorization: Bearer $AVROSH_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"add_knowledge_chapter","arguments":{"business_id":"926135ac-487d-4367-8bad-25397d0d4b87","title":"Opening hours","body":"Mon-Sat 09:00-18:00, closed Sunday."}}}'Response
The result arrives as an MCP content block; the JSON below is what the text field parses to.
{
"chapter": {
"id": "3f9a…",
"title": "Opening hours"
},
"chaptersTotal": 3
}Authentication
Every request carries Authorization: Bearer avk_…. Create a key in the Avrosh dashboard under Docs; it is shown once, because only its hash is stored.
One key reaches every business on the account that made it, and no others. There are no scopes to configure and nothing to switch on — a connected assistant receives the whole toolset. What bounds it is whose account the key belongs to, which is enforced in the database rather than by a permission anybody sets.
curl https://us.avrosh.com/mcp \
-H "Authorization: Bearer $AVROSH_KEY"All tools
list_businesses · get_business · list_calls · get_transcript · create_business · update_business · list_knowledge · add_knowledge_chapter · update_knowledge_chapter · delete_knowledge_chapter · restore_knowledge_chapter · list_menu_items · create_menu_item · update_menu_item · set_menu_item_availability · delete_menu_item · restore_menu_item · remove_menu_item_photo · set_menu_item_thumbnail · list_bookable_types · create_bookable_type · update_bookable_type · set_bookable_type_schedule · delete_bookable_type · restore_bookable_type · list_bookings · get_booking · confirm_booking · cancel_booking · list_work_queue · accept_order · finish_order · accept_request · finish_request · assign_request · list_customers · get_customer · export_customer_data · erase_customer