DevelopersRead only

list_knowledge

API reference — one of six tools an AI assistant can call on an Avrosh account.

What it does

Every knowledge chapter this business has written about itself, with the full text of each - this is what the AI is grounded on when a customer asks a factual question. Read it before ANY knowledge write: update the existing chapter on a subject instead of adding a second one, because two chapters that disagree both feed the AI. A chapter deleted in the last 7 days is not listed but can be restored with restore_knowledge_chapter. A just-written chapter takes about a minute to become retrievable by the AI.

This is the exact text the model reads before deciding to call.

Parameters

business_idstringrequired

The id returned by list_businesses.

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":"list_knowledge","arguments":{"business_id":"926135ac-487d-4367-8bad-25397d0d4b87"}}}'

Response

The result arrives as an MCP content block; the JSON below is what the text field parses to.

{
  "chapters": [
    {
      "id": "3f9a…",
      "title": "Opening hours",
      "text": "Mon-Sat 09:00-18:00, closed Sunday.",
      "sortOrder": 0
    },
    {
      "id": "58b1…",
      "title": "Parking",
      "text": "Free parking behind the building, enter from Jl. Melati.",
      "sortOrder": 1
    }
  ]
}

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"