Skip to main content
Glama

Set up a business (guided)

owner_setup
Idempotent

Only for business owners signed in to Awning. Creates or continues a business's setup from what the owner told you; never invent details. Each answer says what is missing and what next (instructions_for_assistant); keep draft_id. Not for a live business: use owner_update_business, owner_add_offering, owner_update_offering or owner_set_schedule instead.

Input Schema

NameRequiredDescriptionDefault
answersNoWhat the owner said, structured; send only what is new or changed
draft_idNoFrom an earlier answer; leave out the first time
new_businessNoStart another business
copy_from_business_idNoStart another location, copying this business's services, hours and rules

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed59 schema fields changed
    • addedInput schema / properties / answers / description
      Added value: +"What the owner said, structured; send only what is new or changed"
    • changedInput schema / properties / answers / properties / category / description
      Previous value: -"Category code from needs_confirmation options, or a few words like 'hair salon'"New value: +"A code from needs_confirmation, or words like 'hair salon'"
    • removedInput schema / properties / answers / properties / category / maxLength
      Removed value: -120
    • removedInput schema / properties / answers / properties / city / maxLength
      Removed value: -80
    • addedInput schema / properties / answers / properties / contact / description
      Added value: +"Public contacts; channel: where requests reach the owner"
    • removedInput schema / properties / answers / properties / contact / properties / instagram / maxLength
      Removed value: -200
    • removedInput schema / properties / answers / properties / contact / properties / phone / maxLength
      Removed value: -200
    • removedInput schema / properties / answers / properties / contact / properties / public_email / maxLength
      Removed value: -200
    • removedInput schema / properties / answers / properties / contact / properties / website / maxLength
      Removed value: -200
    • removedInput schema / properties / answers / properties / contact / properties / whatsapp / maxLength
      Removed value: -200
    • removedInput schema / properties / answers / properties / country / maxLength
      Removed value: -60
    • changedInput schema / properties / answers / properties / currency / description
      Previous value: -"ISO 4217; derived from country when omitted"New value: +"ISO 4217; from the country if left out"
    • removedInput schema / properties / answers / properties / currency / maxLength
      Removed value: -10
    • removedInput schema / properties / answers / properties / description / maxLength
      Removed value: -1000
    • addedInput schema / properties / answers / properties / hours / description
      Added value: +"Local, 24-hour: [{\"days\":\"mon-sat\",\"open\":\"09:00\",\"close\":\"18:00\"}]; days also \"daily\", [\"tue\",\"thu\"]; a break is two ranges"
    • removedInput schema / properties / answers / properties / hours / items / properties / close / description
      Removed value: -"HH:MM"
    • removedInput schema / properties / answers / properties / hours / items / properties / close / maxLength
      Removed value: -20
    • changedInput schema / properties / answers / properties / hours / items / properties / days / anyOf
      Previous value: -[
      -  {
      -    "maxLength": 100,
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "maxLength": 20,
      -      "type": "string"
      -    },
      -    "maxItems": 14,
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / answers / properties / hours / items / properties / days / description
      Removed value: -"e.g. \"mon-sat\", \"daily\", [\"tue\",\"thu\"]"
    • removedInput schema / properties / answers / properties / hours / items / properties / open / description
      Removed value: -"HH:MM"
    • removedInput schema / properties / answers / properties / hours / items / properties / open / maxLength
      Removed value: -20
    • removedInput schema / properties / answers / properties / hours / maxItems
      Removed value: -100
    • removedInput schema / properties / answers / properties / languages / items / maxLength
      Removed value: -35
    • removedInput schema / properties / answers / properties / languages / maxItems
      Removed value: -20
    • removedInput schema / properties / answers / properties / location / properties / address / maxLength
      Removed value: -200
    • removedInput schema / properties / answers / properties / name / maxLength
      Removed value: -120
    • addedInput schema / properties / answers / properties / offerings / description
      Added value: +"Services, classes and rentals. Prices in major units (2500); duration_min in minutes; price_from: a starting price; quote_only: price on request; rentals: units, deposit; classes: capacity, schedule [{\"days\":\"tue\",\"time\":\"18:30\"}]; options: paid extras."
    • removedInput schema / properties / answers / properties / offerings / items / properties / capacity / description
      Removed value: -"Classes: people per class"
    • removedInput schema / properties / answers / properties / offerings / items / properties / description / maxLength
      Removed value: -600
    • removedInput schema / properties / answers / properties / offerings / items / properties / name / maxLength
      Removed value: -120
    • removedInput schema / properties / answers / properties / offerings / items / properties / options / items / properties / name / maxLength
      Removed value: -200
    • removedInput schema / properties / answers / properties / offerings / items / properties / options / maxItems
      Removed value: -50
    • removedInput schema / properties / answers / properties / offerings / items / properties / price / description
      Removed value: -"In major units of the business currency, e.g. 2500"
    • removedInput schema / properties / answers / properties / offerings / items / properties / price_from / description
      Removed value: -"Price is 'from'"
    • removedInput schema / properties / answers / properties / offerings / items / properties / schedule / description
      Removed value: -"Classes: when they run"
    • changedInput schema / properties / answers / properties / offerings / items / properties / schedule / items / properties / days / anyOf
      Previous value: -[
      -  {
      -    "maxLength": 100,
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "maxLength": 20,
      -      "type": "string"
      -    },
      -    "maxItems": 14,
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / answers / properties / offerings / items / properties / schedule / items / properties / days / description
      Removed value: -"e.g. \"mon-sat\", \"daily\", [\"tue\",\"thu\"]"
    • removedInput schema / properties / answers / properties / offerings / items / properties / schedule / items / properties / time / maxLength
      Removed value: -20
    • removedInput schema / properties / answers / properties / offerings / items / properties / schedule / maxItems
      Removed value: -50
    • removedInput schema / properties / answers / properties / offerings / items / properties / units / description
      Removed value: -"Rentals: how many identical items"
    • removedInput schema / properties / answers / properties / offerings / maxItems
      Removed value: -100
    • addedInput schema / properties / answers / properties / photos_done / description
      Added value: +"The owner is done with photos"
    • addedInput schema / properties / answers / properties / policies / description
      Added value: +"Booking rules: min_advance_hours ahead; free cancellation until free_cancel_hours before, then late_fee_pct kept; auto_confirm false: the owner confirms each request"
    • addedInput schema / properties / answers / properties / skip / description
      Added value: +"Steps the owner skips"
    • addedInput schema / properties / answers / properties / staff / description
      Added value: +"People or rooms that take bookings; hours only where they differ from the business's"
    • removedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / close / description
      Removed value: -"HH:MM"
    • removedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / close / maxLength
      Removed value: -20
    • changedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / days / anyOf
      Previous value: -[
      -  {
      -    "maxLength": 100,
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "maxLength": 20,
      -      "type": "string"
      -    },
      -    "maxItems": 14,
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / days / description
      Removed value: -"e.g. \"mon-sat\", \"daily\", [\"tue\",\"thu\"]"
    • removedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / open / description
      Removed value: -"HH:MM"
    • removedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / open / maxLength
      Removed value: -20
    • removedInput schema / properties / answers / properties / staff / items / properties / hours / maxItems
      Removed value: -100
    • removedInput schema / properties / answers / properties / staff / items / properties / name / maxLength
      Removed value: -200
    • removedInput schema / properties / answers / properties / staff / maxItems
      Removed value: -100
    • changedInput schema / properties / answers / properties / timezone / description
      Previous value: -"IANA, required in countries with several time zones"New value: +"IANA; needed where a country has several"
    • removedInput schema / properties / answers / properties / timezone / maxLength
      Removed value: -64
    • changedInput schema / properties / copy_from_business_id / description
      Previous value: -"Start a branch: copy services, prices, hours, staff and rules from a business this owner runs"New value: +"Start another location, copying this business's services, hours and rules"
    • addedInput schema / properties / draft_id / description
      Added value: +"From an earlier answer; leave out the first time"
    • changedInput schema / properties / new_business / description
      Previous value: -"Start another business even if one is still being set up"New value: +"Start another business"
  2. Changed33 schema fields changed
    • addedInput schema / properties / answers / properties / category / maxLength
      Added value: +120
    • addedInput schema / properties / answers / properties / city / maxLength
      Added value: +80
    • addedInput schema / properties / answers / properties / contact / properties / instagram / maxLength
      Added value: +200
    • addedInput schema / properties / answers / properties / contact / properties / phone / maxLength
      Added value: +200
    • addedInput schema / properties / answers / properties / contact / properties / public_email / maxLength
      Added value: +200
    • addedInput schema / properties / answers / properties / contact / properties / website / maxLength
      Added value: +200
    • addedInput schema / properties / answers / properties / contact / properties / whatsapp / maxLength
      Added value: +200
    • addedInput schema / properties / answers / properties / country / maxLength
      Added value: +60
    • addedInput schema / properties / answers / properties / currency / maxLength
      Added value: +10
    • addedInput schema / properties / answers / properties / description / maxLength
      Added value: +1000
    • addedInput schema / properties / answers / properties / hours / items / properties / close / maxLength
      Added value: +20
    • changedInput schema / properties / answers / properties / hours / items / properties / days / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 100,
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "maxLength": 20,
      +      "type": "string"
      +    },
      +    "maxItems": 14,
      +    "type": "array"
      +  }
      +]
    • addedInput schema / properties / answers / properties / hours / items / properties / open / maxLength
      Added value: +20
    • addedInput schema / properties / answers / properties / hours / maxItems
      Added value: +100
    • addedInput schema / properties / answers / properties / languages / items / maxLength
      Added value: +35
    • addedInput schema / properties / answers / properties / languages / maxItems
      Added value: +20
    • addedInput schema / properties / answers / properties / location / properties / address / maxLength
      Added value: +200
    • addedInput schema / properties / answers / properties / name / maxLength
      Added value: +120
    • addedInput schema / properties / answers / properties / offerings / items / properties / description / maxLength
      Added value: +600
    • addedInput schema / properties / answers / properties / offerings / items / properties / name / maxLength
      Added value: +120
    • addedInput schema / properties / answers / properties / offerings / items / properties / options / items / properties / name / maxLength
      Added value: +200
    • addedInput schema / properties / answers / properties / offerings / items / properties / options / maxItems
      Added value: +50
    • changedInput schema / properties / answers / properties / offerings / items / properties / schedule / items / properties / days / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 100,
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "maxLength": 20,
      +      "type": "string"
      +    },
      +    "maxItems": 14,
      +    "type": "array"
      +  }
      +]
    • addedInput schema / properties / answers / properties / offerings / items / properties / schedule / items / properties / time / maxLength
      Added value: +20
    • addedInput schema / properties / answers / properties / offerings / items / properties / schedule / maxItems
      Added value: +50
    • addedInput schema / properties / answers / properties / offerings / maxItems
      Added value: +100
    • addedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / close / maxLength
      Added value: +20
    • changedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / days / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 100,
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "maxLength": 20,
      +      "type": "string"
      +    },
      +    "maxItems": 14,
      +    "type": "array"
      +  }
      +]
    • addedInput schema / properties / answers / properties / staff / items / properties / hours / items / properties / open / maxLength
      Added value: +20
    • addedInput schema / properties / answers / properties / staff / items / properties / hours / maxItems
      Added value: +100
    • addedInput schema / properties / answers / properties / staff / items / properties / name / maxLength
      Added value: +200
    • addedInput schema / properties / answers / properties / staff / maxItems
      Added value: +100
    • addedInput schema / properties / answers / properties / timezone / maxLength
      Added value: +64
  3. First observed

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations cover the safety profile (idempotent, non-destructive, closed-world), and the description adds genuinely behavioral context: this is a multi-turn guided flow that must not invent details, must preserve draft_id, and returns instructions_for_assistant explaining what is missing. It does not spell out what happens on new_business or copy_from_business_id, which keeps it from a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four dense sentences with zero filler, and the gating condition is front-loaded before the description of the guided behavior and the sibling alternatives. Every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex nested guided-setup tool with no output schema, the description covers the essential context an agent needs: auth precondition, multi-turn draft handling, anti-hallucination constraint, response guidance and routing to other tools. It could go further on the live-business boundary and on starting additional businesses/locations, but nothing critical is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and the nested schema already documents answers, draft_id, new_business and copy_from_business_id in detail. The description adds only the operational reminder to keep draft_id and the constraint to use only what the owner said — useful but limited beyond the schema baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Creates or continues a business's setup') and immediately scopes it to signed-in business owners. It explicitly names the sibling tools that handle a live business, so an agent can distinguish it without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit precondition ('Only for business owners signed in to Awning') and an explicit exclusion with alternatives ('Not for a live business: use owner_update_business, owner_add_offering, owner_update_offering or owner_set_schedule instead'). No inference is required.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources