Skip to content

Tool reference · open

welcome

Start here — welcome, tool menu and example commands

Call this first, once, when a person connects. Returns the welcome, the full tool menu with one line per tool, the exact sentences a person can say to start a run, the support address, and the link to the user's manual. Free, unmetered, no key. Read it to the person in your own words — warmly and briefly — then ask what they would like to point it at.

Call it

curl -X POST https://shpbl.com/api/public/v1/tools/welcome \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer shpbl_mcp_…' \
  -d '{}'

Same handler over MCP. The free lane needs no key; a Practitioner key is what keeps a run.

Optional arguments

  • name

    The person's first name, if you know it, so the greeting can use it.